Last update 6/09/2018

1. Delivery and Invoicing data

Some payment methods or features may require you to submit delivery and/or invoicing information. Here below we've listed the relevant fields you may have to submit:

Format: AN= Alphanumeric / N=Numeric, maximum allowed amount of characters
Field
Description
Format
CIVILITY
Invoicing title (Mr., Mrs, Dr., etc.)
AN, 5
CUID
Social security number / company registration number
AN, 50
ECOM_BILLTO_POSTAL_CITY
Invoicing city
AN, 40
ECOM_BILLTO_POSTAL_COUNTRYCODE
Invoicing country code (BE, FR, NL, DE, etc.)
AN, 2
ECOM_BILLTO_POSTAL_NAME_FIRST
Invoicing first name
AN, 35
ECOM_BILLTO_POSTAL_NAME_LAST
Invoicing last name
AN, 35
ECOM_BILLTO_POSTAL_POSTALCODE
Invoicing postcode
AN, 10
ECOM_BILLTO_POSTAL_STREET_LINE1
Invoicing address
AN, 35
ECOM_BILLTO_POSTAL_STREET_NUMBER
Invoicing street number
AN, 10
ECOM_SHIPTO_DOB
Date of birth
yyyy-MM-dd
ECOM_SHIPTO_ONLINE_EMAIL
Delivery e-mail address
AN, 50
ECOM_SHIPTO_POSTAL_CITY
Delivery city
AN, 25
ECOM_SHIPTO_POSTAL_COUNTRYCODE
Delivery country code (ISO)
AN, 2
ECOM_SHIPTO_POSTAL_NAME_FIRST
Delivery first name
AN, 35
ECOM_SHIPTO_POSTAL_NAME_LAST
Delivery last name
AN, 35
ECOM_SHIPTO_POSTAL_NAME_PREFIX
Delivery civil status (Mr., Mrs, etc.)
AN, 10
ECOM_SHIPTO_POSTAL_POSTALCODE
Delivery postcode
AN, 10
ECOM_SHIPTO_POSTAL_STATE
Delivery state (ISO code *) AN, 2
ECOM_SHIPTO_POSTAL_STREET_LINE1 Delivery address AN, 35
ECOM_SHIPTO_POSTAL_STREET_NUMBER Delivery street number AN, 10
ORDERSHIPCOST
Delivery cost N
ORDERSHIPMETH
Delivery method AN, 25
ORDERSHIPTAXCODE
Delivery tax code N

(*ISO codes for US States can be found here. Example: AL (Alabama), FL (Florida))

2. Order data ("ITEM" parameters)

Some payment methods or features may require you to submit detailed order information. For payment methods on invoice (e.g. the Open Invoice payment method), it is compulsory to submit detailed order information. The following fields can be used in this case. Please note that we can only guarantee the processing of transactions that include ITEM parameters when the payment method submitted is on invoice. Here below we've listed the relevant fields you may have to submit:

Format: AN= Alphanumeric / N=Numeric, maximum allowed amount of characters
Field
Description
Format
ITEMATTRIBUTES*xx*
Item attributes (size, colour etc.) (replace *xx* with a number to send multiple items: ITEMATTRIBUTES1, ITEMATTRIBUTES2, etc.)
AN, 50
ITEMCATEGORY*xx*
Item category (replace *xx* with a number to send multiple items: ITEMCATEGORY1, ITEMCATEGORY2, etc.)
AN, 50
ITEMCOMMENTS*xx*
Item comments (replace *xx* with a number to send multiple items: ITEMCOMMENTS1, ITEMCOMMENTS2, etc.)
AN, 255
ITEMDESC*xx*
Item description (replace *xx* with a number to send multiple items: ITEMDESC1, ITEMDESC2, etc.)
AN, 16
ITEMDISCOUNT*xx*
Item discount (replace *xx* with a number to send multiple items: ITEMDISCOUNT1, ITEMDISCOUNT2, etc.)
N, 10
ITEMID*xx*
Item identification (replace *xx* with a number to send multiple items: ITEMID1, ITEMID2, etc.)
AN, 15
ITEMNAME*xx*
Item name (replace *xx* with a number to send multiple items: ITEMNAME1, ITEMNAME2, etc.) AN, 40
ITEMPRICE*xx*
Item price (replace *xx* with a number to send multiple items: ITEMPRICE1, ITEMPRICE2, etc.) N, 50
ITEMQUANT*xx*
Item quantity (replace *xx* with a number to send multiple items: ITEMQUANT1, ITEMQUANT2, etc.) N, 50
ITEMQUANTORIG*xx*
Maximum quantity per item (replace *xx* with a number to send multiple items: ITEMQUANTORIG1, ITEMQUANTORIG2, etc.)
AN, 50
ITEMUNITOFMEASURE*xx*
Item Unit of measure (replace *xx* with a number to send multiple items: ITEMUNITOFMEASURE1, ITEMUNITOFMEASURE2, etc.)
AN, 50
ITEMVAT*xx* Item VAT amount (replace *xx* with a number to send multiple items: ITEMVAT1, ITEMVAT2, etc.)
N, 50
ITEMVATCODE*xx*
Item VAT code (replace *xx* with a number to send multiple items: ITEMVATCODE1, ITEMVATCODE2, etc.) N, 50
ITEMWEIGHT*xx*
Item weight (replace *xx* with a number to send multiple items: ITEMWEIGHT1, ITEMWEIGHT2, etc.) N, 10

Important: Ascending order of line item fields for SHA calculation
  • Please note that as from 10 consecutive line item fields, the order of the fields for the SHA calculation may differ from what is expected on your system's side. Where we normally stress that all fields should be sorted alphabetically for the SHA calculation, a "logical" ascending order is put in place for the line item fields:
    Example of expected (ascending) order:
    - ITEMNAME1, ITEMNAME2, ITEMNAME3, ITEMNAME4, ITEMNAME5, ITEMNAME6, ITEMNAME7, etc.

  • If an item field in a consecutive list of item fields is skipped or empty, the system will not include any of the item field(s) following the empty parameter in the string to hash.
    Example: If ITEMNAME1, ITEMNAME2, ITEMNAME4 and ITEMNAME5 are submitted (while ITEMNAME3 is blank or skipped), the string to hash will only contain ITEMNAME1 and ITEMNAME2.