Here we describe the Level 2/3 data fields you need to provide for various Level 2/3 programs.
US Level 2/3 programs from MasterCard, Visa, and American Express
To qualify for the US Commercial Card Level 2/3 program of MasterCard and Visa, and the Corporate Purchasing Solution (CPS) program of American Express, you need to provide the following fields in additionalData.
enhancedSchemeData
| Field | Type | Level 2 | Level 3 | Max. length | Description |
|---|---|---|---|---|---|
customerReference
|
String |  |
|
25 |
Customer code, if supplied by a customer. Encoding: ASCII. |
totalTaxAmount
|
Numeric | |
|
12 |
Total tax amount, in minor units. For example, 2000 means USD 20.00 |
freightAmount
|
Numeric |  |
|
12 |
Shipping amount, in minor units. For example, 2000 means USD 20.00 |
dutyAmount
|
Numeric | |
|
12 |
Duty amount, in minor units. For example, 2000 means USD 20.00 |
destinationPostalCode
|
String | |
|
10 |
The postal code of a destination address. Encoding: ASCII. Required for American Express. |
destinationStateProvinceCode
|
String | |
|
3 |
Destination state or province code. Encoding: ASCII. |
shipFromPostalCode
|
String | |
|
10 |
The postal code of a "ship-from" address. Encoding: ASCII. |
destinationCountryCode
|
String | |
|
3 |
Destination country code. Encoding: ASCII. |
orderDate
|
String | |
|
6 |
Order date. Format: ddMMyy Encoding: ASCII. |
enhancedSchemeData.itemDetailLine
| Field | Type | Level 2 | Level 3 | Max. length | Description |
|---|---|---|---|---|---|
commodityCode
|
String | |
|
12 |
Item commodity code. Encoding: ASCII. |
description
|
String | |
|
26 |
Item description. Encoding: ASCII. Cannot contain all zeros or all spaces. |
productCode
|
String | |
|
12 |
Product code. Encoding: ASCII. Cannot contain all zeros or all spaces. Item description can be reused. |
quantity
|
Numeric | |
|
12 |
Quantity, specified as an integer value. Value must be greater than 0. |
unitOfMeasure
|
|
|
3 |
Item unit of measurement. Encoding: ASCII. |
|
unitPrice
|
Numeric | |
|
12 | Unit price, specified in minor units. |
discountAmount
|
Numeric | |
|
12 |
Discount amount, in minor units. For example, 2000 means USD 20.00 |
totalAmount
|
Numeric | |
|
12 |
Total amount, in minor units. For example, 2000 means USD 20.00 |
You can submit a maximum of 9 line items.
UK Visa Global Invoice Specification
To qualify for the UK Visa Global Invoice Specification (VGIS) program, you need to provide the following fields in additionalData.
enhancedSchemeData
| Field | Type | Level 2 | Level 3 | Max. length | Description |
|---|---|---|---|---|---|
vgisXml
|
String | |
No limit |
The XML invoice Encoding: json escaped for JSON requests, XML escaped for SOAP requests. |