E-invoice

For the e-invoice, you need to send e.g. the reference number received from the customer check. Note that you might not want to wait for more than maybe a few days or so after the customer check to make an e-invoice. You can only make an e-invoice of the same amount that you made the customer check function call with. A customer check must be done prior to making an e-invoice. E-invoices is only available for acquirers Kreditor, AK Finans Sweden and Aktiv Kapital Norway.
Kreditor e-invoices can be refunded.

The purpose of the customer check is to provide extra safety for you by letting the acquirer perform a check-up on your customer before creating the actual invoice. After completing a successful customer check, you can then create the actual invoice.

Parameter overview

To create an Arvato e-invoice request to DIBS, use the following parameters.

Field name Description
verifyID DIBS’s reference number, as returned from the customer check
call.
extra Extra parameters, to be saved at DIBS (URL parameter style).
invoiceNo: you can specify the invoice number by using the parameter invoiceNo. If you do not specify invoiceNo in the customercheck, you must do it in the einvoice. (Dependant)
The MAC parameter should be included in the extra string. For this call MAC base formula 1 should be used:
X('verifyID&SecretKey&')
Observe that the name “extra” is never explicitly used in the calls, only the wanted parameters and their values.

Returned data

Field name Description
resultCode Return code of the function call. This may be an error code.
See Return Codes chapter.
acquirerResponseCode The acquirer's response code for the e-invoice. Contact DIBS for the latest code list.

 

Aktiv Kapital Norway E-invoice

To create an Aktiv Kapital Norway e-invoice request to DIBS, use the same parameters as for AK Finans Sweden e-invoice.

Aktiv Kapital ASA group acquirer response codes

Acquirer response codes from AK see Web manual appendix I; Acquirer response codes Aktiv Kapital ASA group acquirer response codes.

To create a Kreditor e-invoice request to DIBS, use the following parameters.

Field Description
verifyID
DIBS’s reference number, as returned from the customer check call.
extra Extra parameters (URL parameter style), to be saved at DIBS and sent to Kreditor.
transID: Identification of the payment. Must be the same value as used in the customer check call. (Required)
amount: Total amount of the payment as returned from the customer check call, VAT included. Numeric value. The amount must be given in pence, cents, etc. (Required) shipmentType: If this parameter is sent in the e-invoice call then this value overrrides the value sent in the customer check call. For more details on this parameter see the Kreditor customer check parameter description. (Optional)
OCR: If this parameter is sent in the e-invoice call then this value overrrides the value sent in the customer check call. For more details on this parameter see the Kreditor customer check parameter description. (Optional)
If the MAC parameter is used, it should be included in the extra string. For this call MAC base formula 1 should be used: X('verifyID&SecretKey&') Observe that the name “extra” is never explicitly used in the
calls, only the wanted parameters and their values.

Returned data

Field name Description
resultCode Return code of the function call. This may be an error code.
See Return Codes chapter.
resultText Returns a short text explaining the result code. See Return Codes chapter.
verifyID DIBS’s reference number (used when contacting DIBS).
amount The total amount of the payment, VAT included.
acquirerAuthResponseCode Kreditor's unfiltered e-invoice response code and e-invoice status. The merchant must be enabled to receive this code.
Contact DIBS for the latest code list.
acquirerAuthCode For a successful Kreditor e-invoice call this value holds the invoice number returned from Kreditor. The merchant must be enabled to receive this code.

It is possible to refund Kreditor e-invoices. Both full amount and multiple part amount refunds are supported, but not overrefunds. To refund a Kreditor e-invoice, send a refund request to DIBS with the following parameters.

Field name Description
verifyID
DIBS’s reference number, as returned from the customer check call.
extra Extra parameters (URL parameter style), to be saved at DIBS and sent to Kreditor.
transID: Identification of the payment. Must be the same value as used in the customer check call. (Required)
amount: The amount to be refunded, VAT included. Numeric value. The amount must be given in pence, cents, etc. (Required)
If the MAC parameter is used, it should be included in the extra string. For this call MAC base formula 1 should be used: X('verifyID&SecretKey&')
Observe that the name “extra” is never explicitly used in the calls, only the wanted parameters and their values.

Returned data

Field name Description
resultCode Return code of the function call. This may be an error code.
See Return Codes chapter.
resultText Returns a short text explaining the result code. See Return Codes chapter.
verifyID DIBS’s reference number (used when contacting DIBS).
amount The total amount of the refund, VAT included.
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