Level 2/3 processing

Send Level 2/3 data on payins

Level 2 and Level 3 data is submitted with a business or commercial card to provide additional benefit to the cardholder through enhanced payment information, and benefits the merchant with lower interchange rates assessed by the card networks (Visa and Mastercard).

Where practical, it is highly recommended that Level 2 and Level 3 data be included in a payin request.

The following fields can be provided in the payin config request.
Note: Only some fields are required for Level 2 qualification.

Field NameDescriptionTypeLevel 2Level 3
tax_amountThe sales tax included in the total payment amount associated with the item(s) being purchased, in minor units.

For example, 1000 is 10.00 USD.
Integer
shipping_amountThe freight or shipping amount included in the total payment amount, in minor units.

For example, 1000 is 10.00 USD.
Integer
order_numberThe purchase order number.String
shipping_countryThe 2-digit country code for the delivery address of the item(s) being purchased.

Find country codes here: https://www.iso.org/obp
String
shipping_postal_codePostal code or ZIP code for the delivery address of the item(s) being purchased. This field can be identical to the shipping_from_postal_code if the customer is present and takes immediate possession of the item(s).String
shipping_from_postal_codePostal code or ZIP code of the address the item(s) being purchased are shipped from.String
line_items (array)The details on the item(s) being purchased.Array

Line Item Fields

Note: All fields are required for Level 3 qualification.

Field NameDescriptionType
product_codeThe merchant defined product code of the item(s) being purchased.String
descriptionThe description of the item(s) being purchased.String
unit_amountThe amount of the item(s) being purchased, in minor units.

For example, 1000 is 10.00 USD.
Integer
quantityThe quantity of the item(s).String
tax_amountThe sales tax on the item(s) being purchased, in minor units.

For example, 1000 is 10.00 USD.
Integer
tax_rateThe percentage representing the value-added tax applied, in per cent mille.

For example, 1000 is 1%.
Integer

See Level 2/3 API specs for additional details.