North America—United States and Canada
The Level 2 card data is additional information attached to a credit card transaction. It is recommended for established businesses with a requirement to process large volumes per transaction or a high number of transactions on a recurring basis.
See the following endpoints when configuring Level 2 data:
Collected data
Collected data
Along with Level 1 data, such as personal consumer card transaction data, Level 2 data includes 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.
Each issuing credit card company provides specific qualifying requirements. The credit card company accepts the enhanced Level 2 payment data only when the business meets the requirements.
Level 2 data requirements
Level 2 data requirements
The following fields are part of the Level 2 data requirements:
| Object | Type | Description |
|---|---|---|
tax_amount | int64 | Part of the transaction amount that indicates the sales tax. A pc_order_number is required when including a tax_amount. |
tax_indicator | integer | Taxable status of the transaction. Values: 0 – No tax information provided 1 – Tax amount is provided 2 – Purchase item is tax exempt or non-taxable |
purchase_identifier | string | Identifier, such as stock keeping unit (SKU), code or reference number that the merchant or customer uses to identify the purchase. |
pc_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 | Delivery location country code. Format: 3-digit code; see the Country code reference for a list of valid values. |
merchant_tax_id | string | Only for Mastercard. Identifier (ID) for the tax collected by the merchant for the transaction. |
product_description | string | Description of the purchased item. |
Credit card breakdown
Credit card breakdown
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 |
Updated 3 months ago
Related topics
