Datastring Parameters

Essential parameters 

The JSON posts that are sent to our API consists of several input parameters which are listed on this page.

The parameter type string is limited to 128 characters.
Please note: Commonly used characters like (& < > " ') are not supported at the moment. You can find a complete list of all supported characters here.
The parameter type int has a maximum value of 2,147,483,647.
Supported fields (noted with asterisks below) have a minimum value of -2,147,483,648.

Items

Parameter Type Description
reference string

The order item reference is usually the SKU (stock keeping unit) of the product.

For convinicence in the case of refunds or modifications towards placed orders, the reference should be unique for each variation of a product item (sizes, colours etc.)

name string

Define the name of the product.

quantity int

Quantity of the specific product in the order. The value '1' will be intepreted as '1'.

unit string

Indicate the defined unit of measurement for the product.
examples: pcs, kg, liter, lbs, meters etc.

unitPrice* int Price of each product unit. This value should always be sent excluding VAT.
taxRate int

Indicate the VAT rate of the product. The value '2500' is intepreted as 25%. The parameter value must be included in your request for the VAT to be displayed correctly in Easy administration. Please note that we do not validate that the tax calculation is correct. 'taxRate' support a value larger or equal to 0.

taxAmount* int

This is the total VAT amount for the order line. '10000' is interpreted as '100.00'. The parameter value must be included in your request for the VAT to be displayed correctly in Easy administration. Please note that we do not validate that the tax calculation is correct.

grossTotalAmount* int

Order line total amount including VAT. '10000' is interpeted as '100.00'. This is the order line parameter we validate when verifying that the total amount for the order is correct.

netTotalAmount* int

Order line total amount excluding VAT. '10000' is interpeted as '100.00'.

* Negative values are allowed for marked parameters. A min value of -2,147,483,648 is now allowed in the fields.

 

Order

Parameter Type Description
amount int

Total amount for the order including VAT. Please note that the order amount must match the sum of all 'grossTotalAmount' parameters in order. '10000' is interpeted as '100.00'.

currency string

Currency of the amount. Use the 3-letter (ISO-4217) code.

reference string

Order ID which will be visible in Easy administration.

 

 

Checkout

Parameter Type Description
url string

This is the URL where the checkout is located at, and where we will send the user after they have preformed a 3-D Secure verification.

Example: https://mydomain.com/checkout

The domain will be validated when the checkout is initialized. The host in the parameter value must match the host where the checkout is initialized.

Read more about the checkout integration in our integration guide.

ShippingCountries string

To specify the shipping countries, the merchant can extend the operation for creating payment with the following input.

Example:

"ShippingCountries" : [{"countryCode":"SSS"},{"countryCode":"SWE"}] 

 

If a country is not in the list, the merchant will be notified with the following error message.
{
    "errors": {
        "checkout.ShippingCountries": [
            "[SSS] as shipping country not supported "
        ]
    }
}

Supported Countries

Country ISO Code
Albania ALB
Andorra AND
Armenia ARM
Austria AUT
Azerbaijan AZE
Belgium BEL
Bulgaria BGR
Bosnia and Herzegovina BIH
Belarus BLR
Switzerland CHE
Cyprus CYP
Czechia CZE
Germany DEU
Denmark DNK
Spain ESP
Estonia EST
Finland FIN
France FRA
United Kingdom GBR
Georgia GEO
Greece GRC
Croatia HRV
Hungary HUN
Ireland IRL
Iceland ISL
Italy ITA
Kazakhstan KAZ
Liechtenstein LIE
Lithuania LTU
Luxembourg LUX
Latvia LVA
Monaco MCO
Moldova MDA
Macedonia MKD
Malta MLT
Montenegro MNE
Netherlands NLD
Norway NOR
Poland POL
Portugal PRT
Romania ROU
Russia RUS
San Marino SMR
Serbia SRB
Slovakia SVK
Slovenia SVN
Sweden SWE
Turkey TUR
Ukraine UKR
Vatican City VAT
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