1. Home
  2. Integration Solutions
  3. Integrations
  4. Optional integration data

Optional integration data

1. Order data ("ITEM" parameters)

Some payment methods or features may require you to submit detailed order 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 / Format Description

ITEMATTRIBUTESxx

AN, 50

 Item attributes (size, colour etc.) (replace *xx* with a number to send multiple items: ITEMATTRIBUTES1, ITEMATTRIBUTES2, etc.)

ITEMCATEGORYxx

AN, 50

 Item category (replace *xx* with a number to send multiple items: ITEMCATEGORY1, ITEMCATEGORY2, etc.)

ITEMCOMMENTSxx

AN, 255

 Item comments (replace *xx* with a number to send multiple items: ITEMCOMMENTS1, ITEMCOMMENTS2, etc.)

ITEMDESCxx

AN, 16

 Item description (replace *xx* with a number to send multiple items: ITEMDESC1, ITEMDESC2, etc.)

ITEMDISCOUNTxx

N,10

 Item discount (replace *xx* with a number to send multiple items: ITEMDISCOUNT1, ITEMDISCOUNT2, etc.)

ITEMIDxx

AN, 15

 Item identification (replace *xx* with a number to send multiple items: ITEMID1, ITEMID2, etc.)

ITEMNAMExx

AN, 40

 Item name (replace *xx* with a number to send multiple items: ITEMNAME1, ITEMNAME2, etc.)

ITEMPRICExx

N, 50

 Item price (replace *xx* with a number to send multiple items: ITEMPRICE1, ITEMPRICE2, etc.)

ITEMQUANTxx

N, 50

 Item quantity (replace *xx* with a number to send multiple items: ITEMQUANT1, ITEMQUANT2, etc.)

ITEMQUANTORIGxx

AN, 50

 Maximum quantity per item (replace *xx* with a number to send multiple items: ITEMQUANTORIG1, ITEMQUANTORIG2, etc.)

ITEMUNITOFMEASURExx

AN, 50

 Item Unit of measure (replace *xx* with a number to send multiple items: ITEMUNITOFMEASURE1, ITEMUNITOFMEASURE2, etc.)

ITEMVATxx

N, 50

 Item VAT amount (replace *xx* with a number to send multiple items: ITEMVAT1, ITEMVAT2, etc.)

ITEMVATCODExx

N, 50

 Item VAT code (replace *xx* with a number to send multiple items: ITEMVATCODE1, ITEMVATCODE2, etc.)

ITEMWEIGHTxx

N, 10

 Item weight (replace *xx* with a number to send multiple items: ITEMWEIGHT1, ITEMWEIGHT2, etc.)

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.

2. 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 / Format Description

CIVILITY

AN, 5

 Invoicing title (Mr., Mrs, Dr., etc.)

CUID

AN, 50

 Social security number / company registration number

ECOM_BILLTO_POSTAL_CITY

AN, 40

 Invoicing city

ECOM_BILLTO_POSTAL_COUNTRYCODE

AN, 2

 Invoicing country code (BE, FR, NL, DE, etc.)

ECOM_BILLTO_POSTAL_NAME_FIRST

AN, 35

 Invoicing first name

ECOM_BILLTO_POSTAL_NAME_LAST

AN, 35

 Invoicing last name

ECOM_BILLTO_POSTAL_POSTALCODE

AN, 10

 Invoicing postcode

ECOM_BILLTO_POSTAL_STREET_LINE1

AN, 35

 Invoicing address

ECOM_BILLTO_POSTAL_STREET_NUMBER

AN, 10

 Invoicing street number

ECOM_SHIPTO_DOB

yyyy-MM-dd

 Date of birth

ECOM_SHIPTO_ONLINE_EMAIL

AN, 50

 Delivery e-mail address

ECOM_SHIPTO_POSTAL_CITY

AN, 25

 Delivery city

ECOM_SHIPTO_POSTAL_COUNTRYCODE

AN, 2

 Delivery country code (ISO)

ECOM_SHIPTO_POSTAL_NAME_FIRST

AN, 35

 Delivery first name

ECOM_SHIPTO_POSTAL_NAME_LAST

AN, 35

 Delivery last name

ECOM_SHIPTO_POSTAL_NAME_PREFIX

AN, 10

 Delivery civil status (Mr., Mrs, etc.)

ECOM_SHIPTO_POSTAL_POSTALCODE

AN, 10

 Delivery postcode

ECOM_SHIPTO_POSTAL_STATE

AN, 2

 Delivery state (ISO code *)

ECOM_SHIPTO_POSTAL_STREET_LINE1

AN, 35

 Delivery address

ECOM_SHIPTO_POSTAL_STREET_NUMBER

AN, 10

 Delivery street number

ORDERSHIPCOST

N

 Delivery cost

ORDERSHIPMETH

AN, 25

 Delivery method

ORDERSHIPTAXCODE

N

 Delivery tax code

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