Datastring Parameters

Essential parameters 

Parameter type description

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

String - The parameter type string is limited to 128 characters and you are able to find a complete list of all supported characters here. The only exception from this is Cherckout.URL which support up to 256 characters.

Int - 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.

Decimal - The parameter type decimal has a maximum value of 79,228,162,514,264,337,593,543,950,335. Supported fields (noted with asterisks below) have a minimum value of -79,228,162,514,264,337,593,543,950,335.

 

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 decimal

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.)
Currently supported currencies: NOK, SEK, DKK & EUR

reference string

Maximum 27 characters for Invoice Payments. 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 performed 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.

termsUrl string

This is the URL where the terms and conditions should be located at. The link will be visible in the checkout.

Example: https://mydomain.com/terms

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 "
        ]
    }
}
consumerType string

This option is used to enable B2B and B2C functionality in the checkout. The example shows how to enable B2B and have B2C be shown by default.

Example:

"consumerType": {"supportedTypes": [ "B2C", "B2B" ],"default": "B2C"}

Supported Countries

Country ISO Code Phone Prefix
Albania ALB 355
Andorra AND 376
Armenia ARM 374
Austria AUT 43
Azerbaijan AZE 994
Belgium BEL 32
Bulgaria BGR 359
Bosnia BIH 387
Belarus BLR 375
Switzerland CHE 41
Cyprus CYP 357
Czechia CZE 420
Germany DEU 49
Denmark DNK 45
Spain ESP 34
Estonia EST 372
Finland FIN 358
France FRA 33
UK GBR 44
Georgia GEO 995
Greece GRC 30
Croatia HRV 385
Hungary HUN 36
Ireland IRL 353
Iceland ISL 354
Italy ITA 39
Kazakhstan KAZ 7
Liechtenstein LIE 423
Lithuania LTU 370
Luxembourg LUX 352
Latvia LVA 371
Monaco MCO 377
Moldova MDA 373
Macedonia MKD 389
Malta MLT 356
Montenegro MNE 382
Netherlands NLD 31
Norway NOR 47
Poland POL 48
Portugal PRT 351
Romania ROU 40
Russia RUS 7
San Marino SMR 378
Serbia SRB 381
Slovakia SVK 421
Slovenia SVN 386
Sweden SWE 46
Turkey TUR 90
Ukraine UKR 380
Vatican City VAT 39
US USA 1
Greenland GRL 299
Afghanistan AFG 93
Angola AGO 244
United Arab Emirates ARE 971
Argentina ARG 54
Antigua & Barbuda ATG 1
Australia AUS 61
Burundi BDI 257
Benin BEN 229
Burkina Faso BFA 226
Bangladesh BGD 880
Bahrain BHR 973
Bahamas BHS 1
Belize BLZ 501
Bolivia BOL 591
Brazil BRA 55
Barbados BRB 1
Brunei BRN 673
Bhutan BTN 975
Botswana BWA 267
Central African Republic CAF 236
Canada CAN 1
Chile CHL 56
China CHN 86
Côte d’Ivoire CIV 225
Cameroon CMR 237
Congo - Kinshasa COD 243
Congo - Brazzaville COG 242
Colombia COL 57
Comoros COM 269
Cape Verde CPV 238
Costa Rica CRI 506
Cuba CUB 53
Djibouti DJI 253
Dominica DMA 1
Dominican Republic DOM 1
Algeria DZA 213
Ecuador ECU 593
Egypt EGY 20
Eritrea ERI 291
Ethiopia ETH 251
Fiji FJI 679
Micronesia FSM 691
Gabon GAB 241
Ghana GHA 233
Guinea GIN 224
Gambia GMB 220
Guinea-Bissau GNB 245
Equatorial Guinea GNQ 240
Grenada GRD 1
Guatemala GTM 502
Guyana GUY 592
Honduras HND 504
Haiti HTI 509
Indonesia IDN 62
India IND 91
Iran IRN 98
Iraq IRQ 964
Israel ISR 972
Jamaica JAM 1
Jordan JOR 962
Japan JPN 81
Kenya KEN 254
Kyrgyzstan KGZ 996
Cambodia KHM 855
Kiribati KIR 686
St. Kitts & Nevis KNA 1
South Korea KOR 82
Kuwait KWT 965
Laos LAO 856
Lebanon LBN 961
Liberia LBR 231
Libya LBY 218
St. Lucia LCA 1
Sri Lanka LKA 94
Lesotho LSO 266
Morocco MAR 212
Madagascar MDG 261
Maldives MDV 960
Mexico MEX 52
Marshall Islands MHL 692
Mali MLI 223
Myanmar MMR 95
Mongolia MNG 976
Mozambique MOZ 258
Mauritania MRT 222
Mauritius MUS 230
Malawi MWI 265
Malaysia MYS 60
Namibia NAM 264
Niger NER 227
Nigeria NGA 234
Nicaragua NIC 505
Nepal NPL 977
Nauru NRU 674
New Zealand NZL 64
Oman OMN 968
Pakistan PAK 92
Panama PAN 507
Peru PER 51
Philippines PHL 63
Palau PLW 680
Papua New Guinea PNG 675
North Korea PRK 850
Paraguay PRY 595
Qatar QAT 974
Rwanda RWA 250
Saudi Arabia SAU 966
Sudan SDN 249
Senegal SEN 221
Singapore SGP 65
Solomon Islands SLB 677
Sierra Leone SLE 232
El Salvador SLV 503
Somalia SOM 252
South Sudan SSD 211
São Tomé & Príncipe STP 239
Suriname SUR 597
Swaziland SWZ 268
Seychelles SYC 248
Syria SYR 963
Chad TCD 235
Togo TGO 228
Thailand THA 66
Tajikistan TJK 992
Turkmenistan TKM 993
Timor-Leste TLS 670
Tonga TON 676
Trinidad & Tobago TTO 1
Tunisia TUN 216
Tuvalu TUV 688
Taiwan TWN 886
Tanzania TZA 255
Uganda UGA 256
Uruguay URY 598
Uzbekistan UZB 998
St. Vincent & Grenadines VCT 1
Venezuela VEN 58
Vietnam VNM 84
Vanuatu VUT 678
Samoa WSM 685
Yemen YEM 967
South Africa ZAF 27
Zambia ZMB 260
Zimbabwe ZWE 263
Hong Kong HKG 852

 

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