Input Parameters

Input parameters used for creating a payment in Payment Window 2.0

The parameters should be sent as a HTML POST or GET to the following URL:

https://securedt.dibspayment.com/verify/bin/<yourAccountName>/index

where <yourAccountName> is your DIBS account name used for logging in to the DIBS Manager.

Essential parameters

Parameters below with an asterix(*) are validated and is mandatory to include in the POST against DIBS. You are still able to send in you own parameters in the POST and receive it back in the response from DIBS, but those parameters are not validated.

Parameter

Description

billingAddress *

Address

billingCity *

Postal address

billingCountry *

Country

billingFirstName *

First name

billingLastName *

Last name

currency *

You have the option of controlling the currency you wish to use via the currency parameter. The value of the currency must be in what is known as the ISO-4217 ISO/SWIFT currency format (e.g. SEK, GBP, USD, NOK, DKK, EUR), and in uppercase letters. Refer to http://currency.xe.net/gen/iso4217.htm for a complete list.

data *

All information applying to the consumer’s order is included in the data parameter. Please refer to our order information page regarding the format of this parameter.

eMail *

Consumer's email address.

MAC *

MAC checksum used to make sure no one has tampered with the information. See the MAC page for more information.

pageSet *

It is possible to set up pages in different languages or for different services that are paid for using DIBS. Each group of pages and reports are called a ”page set”. These are called by entering the name of the page set in the pageSet parameter. Refer to our page set guide for more information.

Default value: 'standard'

authOnly

This parameter is used if a merchant wants to make an authorization without having the DIBS system send an automatic settlement for this order. The DIBS system will only send an automatic settlement for an order with a successful authorization answer. If set to 'true', only the initial authorization will be done, and the settlement can be carried out at a later time wither through the API or using DIBS Manager.

Default value: 'false'

method

DIBS supports several different payment methods. The parameter method is used to define the payment method to be selected for the current order. Please refer to the methods page for possible values. 

Default value: 'cc.amex'

referenceNo

This parameter is used when the customer wish to place a merchant reference number on an order in DIBS system which allows it to be searchable via DIBS Manager.

This parameter must be unique for each new payment.

 

Optional parameters

Parameter

Description

customReturnUrl

Use a varible return url instead of setting a static url in DIBS Manager. This parameter should include your return url for declined or accepted payments (i.e. https://yourdomain.com/dibsreturn/). You are not able to include custom parameters in this url (like https://yourdomain.com/dibsreturn/?orderno=[ver valueof="referenceNo"]).

 

When using customReturnUrl instead of static url, the response from DIBS will be sent as GET instead of POST. You will still receive parameters including prefixes input_ and dibs_.

 

To use this parameter, you need to contact DIBS Support for activation.

customCancelUrl

Use a varible cancel url instead of the standard cancel-button behavior in the Payment Window 2.0. This parameter should include your cancel url for aborted payments (i.e. https://yourdomain.com/dibscancel/). You are not able to include custom parameters in this url (like https://yourdomain.com/dibscancel/?orderno=[ver valueof="referenceNo"]).

 

When using customCancelUrl the response from DIBS will be sent as GET to the cancel URL. No prefixes will be appended.

 

To use this parameter, you need to contact DIBS Support for activation.

language

This parameter determines the language in which the page will be displayed. The following values are accepted:

ar-AR (Arabic formal)


cs-CZ (Czech)

da-DK (Danish)

de-DE (German)

en-US (English)

es-ES (Spanish)

et-EE (Estonian)

el-GR (Greek)

fi-FI (Finnish)

fr-FR (French)

hu-HU (Hungarian)

it-IT (Italian)

ja-JP (Japanese)

lv-LV (Latvian)

nb-NO (Norwegian)

nl-NL (Dutch)

pl-PL (Polish)

pt-PT (Portuguese)

sk-SK (Slovak)

sv-SE (Swedish)

ru-RU (Russian)

ro-RO (Romanian)

zh-CHS (Chinese Simplified)

Default language is English.

separator

If there is a risk that the “:” (colon) character may be included in a stock item name, an alternative separator should be used. Use the separator parameter to enter another separator, which may consist of an optional number of characters. For more information about this parameter, see the order information page.

Default value: ':'

saleType

This parameter can be passed in order to change the sale type of the payment e.g. you want to use the standard template of Payment Window 2.0 for MOTO payments instead of using the MOTO template.

Following values are accepted:

 

E_COMMERCE

 

RECURRING_PAYMENT (only for server-to-server calls)

 

MOTO (mail or telephone order)

 

Default value is E_COMMERCE.

uses3dsecure

3-D Secure is MasterCard's and VISA’s way of securing e-commerce credit card payments. The shop will get “liability shift” (stand no risk for chargebacks) for these payments. Note that this is how it is supposed to work but it is the shop’s responsibility to check this with the acquiring bank. When using 3-D Secure the consumer is authenticated before the normal authorization. Before the issuing banks have their part of 3-D Secure ready the consumer will not see any difference, and the shop will only see an additional authentication transaction for the payment in the DIBS Manager.
 

If the issuing bank has activated the credit card for 3-D Secure, the consumer will be asked to authenticate himself the way the issuing bank has decided (normally with a password) before the normal authorization is done.
 

To be able to use 3-D Secure you have to contact DIBS customer support so they can configure you for this service. If the payment method used requires 3-D Secure it will be used automatically. In some cases exceptions can be made and in those cases DIBS can configure your shop to be able to skip 3-D Secure. If this is the case you have to provide the parameter uses3dsecure=true/false.
 

Note that 3-D Secure works for method parameter cc.cekab, cc.babs, cc.barclays, cc.luottokunta, cc.euroline, cc.valitor and that only VISA and MasterCard cards are authenticated and have the liability shift.

 

Do you have 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