Last update 6/09/2018

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.