Status WebService

The Status WebService can be used to retrieve the status of an already existing payment. This can for example be if the payment was successful or not, and if not, the reason for the rejection

General information

Usage of this web service must be enabled for the shop by the DIBS support department prior to being used.

For security reasons, the web service can only be reached over https.

Web service location details:

Endpoint:

https://secure.incab.se/axis2/services/DTTransactionStatusService_v2

WSDL:

https://secure.incab.se/axis2/services/DTTransactionStatusService_v2?wsdl

Request parameters

The Status WebService accepts the following input parameters.

ParameterDescription
shopNameMerchant shopname, provided by DIBS.
userNameAPI-Username, generated by merchant in DIBS Manager
passwordAPI-User password, generated by merchant in DIBS Manager
verifyIdDIBS reference number
referenceNumberShop reference number

One of either verifyId or referenceNumber must be specified. If both are specified, the verifyId will be used.

Return parameters

The web service will return the following parameters. If a payment has several events, e.g. a seperate authorization and settlement, a set of parameters will be returned for each event.

ParameterDescription
acquirerAcquirer name
creationDateCreation date for the transaction
processDateProcessing date for the transaction. Has the value null if transaction has not been processed by the acquirer
referenceNumberShop reference number
requestedViaThe reference number used for the request. Value will be either "referenceNumber" of "verifyId"
responseCode

Response code for the payment. See below list for possible values

responseTextResponse text for the payment. See below list for possible values
resultCodeResult code for the web service call. See below list for possible values
resultTextResult text for the web service call. See below list for possible values
typeType of transaction, e.g. 'authorization' or 'settlement'
verifyIdDIBS reference number

If an error happens either with the login credentials or if no transaction with the given reference is found, all fields but "resultCode" and "resultText" will be null. These two fields will contain an error code and text descriping what went wrong. 

 

resultCode and resultText

Below are the possible values for resultCode and resultText.

resultCoderesultText
100operation_successful
336web_service_login_failed
397Merchant does not have access
398Missing parameter verifyId and/or referenceNumber
399unable_to_determine_status_code
400too_many_concurrent_sessions
500internal_server_error

 

responseCode and responseText

Below are the possible values for responseCode and responseText.

responseCoderesponseText
100verification_OK
101settlement_OK
102refund_OK
103invoice_OK
109authentication_ok
199processing
200verification_denied
201settlement_denied
202refund_denied
209authentication_denied
307this_shop_is_not_allowed_to_use_the_given_currency
400server_busy
401no_connection_to_bank
402server_error

 

Do you have a question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00