Last update 11/06/2014

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

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:

<input type="hidden" name="DATATYPE" value="">
<input type="hidden" name="AIAIRNAME" value="">
<input type="hidden" name="AITINUM" value="">
<input type="hidden" name="AITIDATE" value="">
<input type="hidden" name="AICONJTI" value="">
<input type="hidden" name="AIPASNAME" value="">
<input type="hidden" name="AIEXTRAPASNAME1" value="">
<input type="hidden" name="AICHDET" value="">
<input type="hidden" name="AIAIRTAX" value="">
<input type="hidden" name="AIVATAMNT" value="">
<input type="hidden" name="AIVATAPPL" value="">
<input type="hidden" name="AITYPCH" value="">
<input type="hidden" name="AIEYCD" value="">
<input type="hidden" name="AIIRST" value="">
<input type="hidden" name="AIORCITY1" value="">
<input type="hidden" name="AIORCITYL1" value="">
<input type="hidden" name="AIDESTCITY1" value="">
<input type="hidden" name="AIDESTCITYL1" value="">
<input type="hidden" name="AISTOPOV1" value="">
<input type="hidden" name="AICARRIER1" value="">
<input type="hidden" name="AIBOOKIND1" value="">
<input type="hidden" name="AIFLNUM1" value="">
<input type="hidden" name="AIFLDATE1" value="">
<input type="hidden" name="AICLASS1" value="">

Format: AN= Alphanumeric / N=Numeric, maximum allowed amount of characters
Name Description Format Mandatory
DATATYPE "TRAVEL" TRAVEL Yes
AIAIRNAME Airline name AN, 20 No
AITINUM

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. 

AN, 16 Yes
AITIDATE Ticket issue date. The default value is the transaction date MM/DD/YYYY or YYYYMMDD No
AICONJTI Conjunction ticket AN, 3 No
AIPASNAME Primary passenger name. The default value is the name of the credit cardholder. AN, 49 No
AIEXTRAPASNAME1 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. AN, 49 No
AICHDET Charge details. Free text description or reference. AN, 49 No
AIAIRTAX Airport taxes num x100 => no decimals No
AIVATAMNT VAT amount num x100 => no decimals No
AIVATAPPL VAT applicable flag. Supported values:
  • D: normal VAT applicable
  • I: no VAT on the transaction
D and I No
AITYPCH Type of charge
AN, 2 No
AIEYCD Destination area code AN, 3 No
AIIRST Destination area code type AN, 1 No

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 Format Mandatory
AIORCITY1 Departure airport (short) AN, 3 (IATA) Yes
AIORCITYL1 Departure airport (long) AN, 20 Yes
AIDESTCITY1 Arrival airport (short) AN, 3 (IATA) Yes
AIDESTCITYL1 Arrival airport (long) AN, 20 Yes
AISTOPOV1

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 
O and X No
AICARRIER1 Carrier code AN, 4 Yes
AIBOOKIND1 Booking indicator AN, 2 No
AIFLNUM1 Flight number AN, 4 No
AIFLDATE1 Flight date MM/DD/YY or YYYYMMDD No
AICLASS1 Airline class AN, 15 No

This website uses cookies to be able to give you the best user experience. If you don't want to accept these cookies, we allow you to change the cookie settings. Click 'Accept' to allow all cookies from this website.

Cookie settings

Introduction

Functional

Functional cookies are required for the website to operate correctly. These cookies cannot be disabled.

Optimized

Optimization cookies allow us to analyze site usage so we can measure and improve our website.
This is the default level.

Personalized

Personalization cookies are used for social media and advanced personalization. They allow us to show you information related to your company.


Example functionality allowed

  • Store country preference
  • Store language preference

Example functionality not allowed

  • Saving personal data
  • Anonymous tracking via Google Analytics
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics

Example functionality not allowed

  • Saving personal data
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics
  • Serve content relevant to your interests
  • Serve ads relevant to your interests
  • Tracking for remarketing purposes

Example functionality not allowed

  • Saving personal data