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:

Object

Type

Description

tax_amount

int64

Indicates the sales tax. An order_number is required when including a tax_amount.

tax_indicator

integer

Taxable 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_identifier

string

Unique identifier that the merchant or customer uses to identify the purchase, example: a stock-keeping unit (SKU), code, or reference number.

order_number

string

Order number or customer reference number reported as part of the purchase card data.

discount_amount

int64

Discount amount for the transaction. Format: cents.

freight_amount

int64

Freight amount included for the transaction. Format: cents.

duty_amount

int64

Duty amount included for the transaction. Format: cents.

destination_postal_code

string

Postal or ZIP code of the delivery location.

shipping_from_postal_code

string

Postal or ZIP code of the shipping location

destination_country_code

integer

Country code of the delivery location. Format: 3 digits. See the Country code reference for a list of valid values.

merchant_tax_id

string

Tax ID collected by the merchant for this transaction (Mastercard only).

product_description

string

Description of the purchased item.

Credit card parameters

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

Card issuer

General information

American Express

  • product_description
  • discount_amount

Mastercard and Visa

  • tax_amount
  • discount_amount

Did this page help you?