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 and you are able to 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.

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 quantity of the product.

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.

 


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