Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Level 2/3 data fields

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
-white_check_mark-
-white_check_mark-
25

Customer code, if supplied by a customer.

Encoding: ASCII.

totalTaxAmount Numeric
-white_check_mark-
-white_check_mark-
12

Total tax amount, in minor units.

For example, 2000 means USD 20.00

freightAmount Numeric
-x-
-x-
12

Shipping amount, in minor units.

For example, 2000 means USD 20.00

dutyAmount Numeric
-x-
-x-
12

Duty amount, in minor units.

For example, 2000 means USD 20.00

destinationPostalCode String
-x-
-x-
10

The postal code of a destination address.

Encoding: ASCII.

Required for American Express.

destinationStateProvinceCode String
-x-
-x-
3

Destination state or province code.

Encoding: ASCII.

shipFromPostalCode String
-x-
-x-
10

The postal code of a "ship-from" address.

Encoding: ASCII.

destinationCountryCode String
-x-
-x-
3

Destination country code.

Encoding: ASCII.

orderDate String
-x-
-x-
6

Order date.

Format: ddMMyy

Encoding: ASCII.

enhancedSchemeData.itemDetailLine

Field Type Level 2 Level 3 Max. length Description
commodityCode String
-x-
-white_check_mark-
12

Item commodity code.

Encoding: ASCII.

description String
-x-
-white_check_mark-
26

Item description.

Encoding: ASCII.

productCode String
-x-
-white_check_mark-
12

Product code.

Encoding: ASCII.

quantity Numeric
-x-
-white_check_mark-
12

Quantity, specified as an integer value.

Value must be greater than 0.

unitOfMeasure
-x-
-white_check_mark-
3

Item unit of measurement.

Encoding: ASCII.

unitPrice Numeric
-x-
-white_check_mark-
12 Unit price, specified in minor units.
discountAmount Numeric
-x-
-x-
12

Discount amount, in minor units.

For example, 2000 means USD 20.00

totalAmount Numeric
-x-
-white_check_mark-
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
N/A
-white_check_mark-
No limit

The XML invoice

Encoding: json escaped for JSON requests, XML escaped for SOAP requests.