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:<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 your own parameters in the POST and receive it back in the response from DIBS, but those parameters are not validated.



billingAddress *


billingCity *

Postal address

billingCountry *


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 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 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'


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'


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: ''


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




Can be used to send a phone number to DIBS. If used together with the payment method direct.swish, it's possible to pre populate the payment window with a phone number.


If using this for Swish. Please remove the first 0 digit in the number.

Example: 0701234567 should be written 701234567


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. You are not able to include custom parameters in this url (like[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.



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. You are not able to include custom parameters in this url (like[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.


NOTE: If you are going to use the parameter customCancelUrl, you will still need to add a static cancel url and choose Activate cancel url and Return all merchant parameters.


Please refer to the Manager documentation on how to activate cancel URL in Manager:

Change settings in Payment Window 2.0 --> Change cancel url





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.


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: ':'


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:




RECURRING_PAYMENT (only for server-to-server calls)


MOTO (mail or telephone order)


Default value is E_COMMERCE.


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.

When the [saleType] is set to MOTO and the [uses3dsecure] is empty - we assume that the payment is allowed to skip 3-D Secure.
Obviously you should only use this exemption for actual MOTO (mail or telephone) payments since there will be no 3-D Secure authentication.

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


This parameter is used for cardholder stored recurring transactions. When this is added the card number associated with the VerifyId you enter will be automatically populated in the payment window. You will need to pass the parameter recurringType=CardholderStored for this to work.


Do you have a question or need help?
Follow us
Nets Online Payments

Oslo: +47 21 55 44 00
Stockholm: +46 (0)8-527 525 00
København: +45 7020 3077
Jyväskylä: + 358 010 80 40 40
Close menu