Return parameters

The parameters returned to the return pages are listed below. All return parameters are encoded using UTF-8. Apart from below parameters, all valid input parameters will be returned as well.

ParameterTypeDescription
acquirerString. Max 20 characters.The acquirer used for the specific transaction.
acquirerCustomerIdString

Customer ID in acquirers system

Only to be used with DIBS Invoice.

acquirerDeliveryAddressString

Customers street address returned by acquirer.

Only to be used with DIBS Invoice.

acquirerDeliveryCountryCodeString

Customers country code returned by acquirer.

Only to be used with DIBS Invoice.

acquirerDeliveryPostalCodeString

Customers postal code returned by acquirer.

Only to be used with DIBS Invoice.

acquirerDeliveryPostalPlaceString

Customers postal place returned by acquirer.

Only to be used with DIBS Invoice.

acquirerFirstNameString

Customers first name as returned from acquirer.

Only to be used with DIBS Invoice.
acquirerLastNameString

Customers last name as returned from acquirer.

Only to be used with DIBS Invoice.

acquirerOrderIdStringOrderId returned by acquirer. If the acquirer does not support this feature then the merchant orderId is returned.
actionCodeString. Max 20 charactersThe response code returned by the acquirer. 
amountLong - Minimum value of 1Amount authorised in smallest unit as stated in the ISO4217 standard,
captureStatusString (ENUM)The status of the capture attempt. Possible values:
  • ACCEPTED: Capture was successful.
  • PENDING: Scheduled for later capture, often through batch.
  • DECLINED: Rejected by either DIBS or the acquirer. More information can be found in DIBS Admin.
  • ERROR: Something went wrong during capture.
Note: Only returned when 'captureNow' is used in the request to DIBS.
cardNumberMaskedString. Max 50 characters. May contain the characters: 0-9XThe card number masked with X’s. The last four digits remain unmasked.
cardTypeNameString. Max 20 characters.The payment type of the card used. Corresponds to the "Description" column of the Paytypes list in the toolbox section.
currencyInteger or stringThe currency code of the transfer in the ISO4217 numeric or alphanumeric form, depending on the format used in the reuest to DIBS.
ECIStringThe Electronic Commerce Indicator. Informs if the transaction was protected by the 3d-Secure security protocol.
  • 01/06: MasterCard/Visa, card not enrolled
  • 02/05: MasterCard/Visa, card enrolled.
  • 07/08: MasterCard/Visa, error in enrollment check.
Note: Only returned on payments through 3d-secure enabled acquirer agreements.
enrollStatusStringCredit card entrollment status.
  • Y for Yes.
  • N for No.
  • U for Unknown.
Note: Only returned on payments through 3d-secure enabled acquirer agreements.
expMonthString. Exactly two digits (zero padded if needed) in the range 1-12.Upon a successful credit card transaction, this parameter contains the expiration month of the credit card used.
expYearString. Exactly two digits (zero padded if needed) representing the last two digits of the year.Upon a successful credit card transaction, this parameter contains the expiration year of the credit card used.
feeLong. Same format as the input parameter amountContains the calculated fee amount in the smallest unit as stated in the ISO4217 standard.
Note: Only returned if 'addFee' is sent in the request.
MACString. Max 64 hexadecimal characters, which fits a SHA-256 code.This parameter contains a MAC key calculated from all the parameters returned to the merchant. Please refer to the HMAC calculation page for more information.
statusStringContains the status of the returned transaction. The following values are possible:
  • ACCEPTED: Transaction was successful
  • DECLINED: Transaction declined
  • PENDING: Awating answer from acquirer.
  • CANCELLED: Payment cancelled by user. This is only returned to the cancelReturnUrl
status3DString3D secure status. Possible values:
  • A: Card enrolled and authentication not performed
  • Y: Card enrolled and authentication successful
  • N: Card not enrolled
Note: Only returned on payments through 3d-secure enabled acquirer agreements.
ticketString. Maximum 100 characters.If 'createTicket' is sent in the request, ticket will replace transaction as the ID. If 'creatTicketAndAuth' is sent, DIBS will return both a ticket and transaction reference.
ticketStatusString (ENUM)The status of the ticket registration attempt. Possible values:
  • ACCEPTED: Ticket created successfully
  • DECLINED: Ticket creation was declined by DIBS or the acquirer.
  • ERROR: An error happened. More information is available in DIBS Admin.
transactionString. Maximum 100 characters.The ID of the transaction is returned if status is ACCEPTED or PENDING. This number will always be a unique transaction identifier in the DIBS system.
validationErrorsStringInput parameters validation errors in JSON format.Example:
{"addFee":["use the value "1" or leave out this parameter"],"currency":["must match "^([0-9]{3}A-Z{3})$""]}
verificationIdPresentBooleanIn Visa transactions represents the Cardholder Authentication Verification Value (CAVV) presence. For Mastercard it indicates if the similar value, called Accountholder Authentication Value (AVV) or the Universal Cardholder Authentication Field (UCAF) is present. Possible values:
  • 1
  • 0
xidPresentBooleanUnique transaction identifier presence indicator during 3D secure verification.

 

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