Level 2 data

Understanding Level 2 data

Level 2 card data is additional information attached to a credit card transaction. It is recommended for established businesses that process large volumes per transaction or process a high number of transactions on a monthly and/or recurring basis.

Endpoints

See following endpoints when configuring L2 data:

Collected data

Along with personal consumer card transaction data (Level 1 data), Level 2 data includes details such as tax amount, tax indicator, tax ID, customer code, and shipping information. Different data is collected based on whether the card is American Express®, Mastercard®, and Visa®. You can add default values for Level 2 data when you set up purchasing card payments on the web Dashboard. This data is auto-populated during the transaction.

Issuer requirements

Each issuing credit card company provides specific qualifying requirements. The credit card company accepts the enhanced Level 2 payment data if a business meets the requirements.

Level 2 data requirements

The following fields are part of the Level 2 data requirements:

ObjectTypeDescription
tax_amountint64Indicates the sales tax. An order_number is required when including a tax_amount.
tax_indicatorintegerTaxable status of the transaction, including:
0 – No tax information provided
1 – Tax amount is provided
2 – Purchase item is tax exempt or non-taxable
purchase_identifierstringUnique identifier that the merchant or customer uses to identify the purchase, example: a stock-keeping unit (SKU), code, or reference number.
order_numberstringOrder number or customer reference number reported as part of the purchase card data.
discount_amountint64Discount amount for the transaction. Format: cents.
freight_amountint64Freight amount included for the transaction. Format: cents.
duty_amountint64Duty amount included for the transaction. Format: cents.
destination_postal_codestringPostal or ZIP code of the delivery location.
shipping_from_postal_codestringPostal or ZIP code of the shipping location
destination_country_codeintegerCountry code of the delivery location. Format: 3 digits. See the Country code reference for a list of valid values.
merchant_tax_idstringTax ID collected by the merchant for this transaction (Mastercard only).
product_descriptionstringDescription of the purchased item.

Credit card parameters

The following table provides the parameters to use for a specific credit card.

Card issuerGeneral information
American Express- product_description
- discount_amount
Mastercard and Visa- tax_amount
- discount_amount

Related topics