Optional integration data

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 / 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))}

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

3. Travel data

You can send additional data for travel transactions if your acquirer is able to receive and process the data.

The hidden fields for travel data are the following:

^{Format: AN= Alphanumeric / N=Numeric, maximum allowed amount of characters}

Field/ Format	Description
DATATYPE TRAVEL	"TRAVEL" Mandatory
AIAIRNAME AN, 20	Airline name Optional
AITINUM AN, 16	Ticket number Air+ defines this zone as follows: 3 digits for airline prefix (filled with 0’s if ticket type <> BSP + 10 chars for ticket number). Other acquirers do not split this zone – it is just the ticket number. Mandatory
AITIDATE MM/DD/YYYY or YYYYMMDD	Ticket issue date. The default value is the transaction date Optional
AICONJTI AN, 3	Conjunction ticket Optional
AIPASNAME AN, 49	Primary passenger name. The default value is the name of the credit cardholder. Mandatory only for acquirer Bambora
AIEXTRAPASNAME1 AN, 49	Name of extra passenger for PNRs with more than one passenger. This field can be repeated up to 5 times (i.e. for 5 extra passengers), changing the digit at the end of the field name. Mandatory only for acquirer Bambora
AICHDET AN, 49	Charge details. Free text description or reference. Optional
AIAIRTAX num x100 => no decimals	Airport taxes Optional
AIVATAMNT num x100 => no decimals	VAT amount Optional
AIVATAPPL D and I	VAT applicable flag. Supported values: D: normal VAT applicable I: no VAT on the transaction Optional
AITYPCH AN, 2	Type of charge Optional
AIEYCD AN, 3	Destination area code Optional
AIIRST AN, 1	Destination area code type Optional

The following fields can be repeated n times, changing the digit at the end of the field name.

^{Format: AN= Alphanumeric / N=Numeric, maximum allowed amount of characters}

Field	Description
AIORCITY1 AN, 3 (IATA)	Departure airport (short) Mandatory
AIORCITYL1 AN, 20	Departure airport (long) Mandatory
AIDESTCITY1 AN, 3 (IATA)	Arrival airport (short) Mandatory
AIDESTCITYL1 AN, 20	Arrival airport (long) Mandatory
AISTOPOV1 O and X	Stopover Possible values: the capital letters O and X. O: the passenger is allowed to stop and stay. X: the passenger is not allowed to stay Optional
AICARRIER1 AN, 4	Carrier code Mandatory
AIBOOKIND1 AN, 2	Booking indicator Optional
AIFLNUM1 AN, 4	Flight number Optional
AIFLDATE1 MM/DD/YY or YYYYMMDD	Flight date Mandatory only for acquirer Bambora
AICLASS1 AN, 15	Airline class Mandatory only for acquirer Bambora

Delivery and Invoicing data
Order data ("ITEM" parameters)
Travel data

Features and use cases

Get started

Integration Solutions

Payment methods

Security

News

Optional integration data

1. Delivery and Invoicing data

2. Order data ("ITEM" parameters)

3. Travel data