Level 2/3 processing
API version 2023-01-01 deprecatingThis version will be deprecated on May 1, 2025. If your platform is on this version, you should upgrade to at least 2023-12-01 to simplify authorization and access new features.
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.
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 Name | Description | Type | Level 2 | Level 3 |
|---|---|---|---|---|
tax_amount | The 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_amount | The freight or shipping amount included in the total payment amount, in minor units. For example, 1000 is 10.00 USD. | Integer | ✔ | ✔ |
order_number | The purchase order number. | String | ✔ | ✔ |
shipping_country | The 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_code | Postal 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_code | Postal 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 Name | Description | Type |
|---|---|---|
product_code | The merchant defined product code of the item(s) being purchased. | String |
description | The description of the item(s) being purchased. | String |
unit_amount | The amount of the item(s) being purchased, in minor units. For example, 1000 is 10.00 USD. | Integer |
quantity | The quantity of the item(s). | String |
tax_amount | The sales tax on the item(s) being purchased, in minor units. For example, 1000 is 10.00 USD. | Integer |
tax_rate | The 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.
Updated 7 days ago