Submit Level 2 and Level 3 Data with Transactions
To take advantage of lower interchange rates, you must submit Level 2 and Level 3 data along with the transaction. This ensures the customer’s card brand network can receive and assess the data to determine which interchange rate the transaction will receive.
If you’re not sure what data each interchange level requires, visit Understanding Interchange Data Requirements.
Before You Begin
Before you begin submitting Level 2 or Level 3 data, we recommend checking each card’s Level 2 and Level 3 processing eligibility. This process involves tokenizing the card and checking its bank identification number (BIN) for information about the card brand and card type.
Create a Card Token
You can query the BIN of a customer’s card only if the card has been tokenized. To create a token for the customer’s card:
Send a
POST https://test-api.payrix.com/tokens
request with the following payload, adjusting the value for each parameter in the request body:
{
"customer": "{customerID}",
"payment": {
"number": "{customerCardNumber}",
"cvv": "{customerCardCVV}"
},
"expiration": "{MMYY}"
}
The following table describes the required request body parameters:
Required Parameter | Type | Description | Valid Values and Format | |
---|---|---|---|---|
| string | The unique identifier of the customer. | Example: | |
| object | The payment method associated with the customer, including the card details. | Not applicable | |
| string | The card number of the credit card associated with the payment method. | Example: | |
| string | The card verification value (CVV) of the credit card associated with the payment method. | This field is expressed as a three-digit string. | |
| string | The expiration date of the payment method (in this case, a credit card) associated with the payment method. | This field is stored as a text string in MMYY format, where MM is the number of a month and YY is the last two digits of a year. For example, |
In the response, copy the auto-generated token identifier in the
token
field returned by the endpoint. You'll need this value in subsequent API calls. The following example shows the structure of a successful response with tokenized payment method information:
{
"response": {
"data": [
{
"payment": {},
"token": "01234ab56c7890d1e293b456cfd7f8be"
}
],
"details": {},
"errors": []
}
}
Identify the Card Type
Visa and MasterCard are the only card brands that can receive additional data to influence their interchange rates. In contrast, American Express and Discover don’t offer direct data submission options for Level 2 or 3 data to obtain lower interchange rates. As a result, we recommend verifying the card brand before submitting data with the intention of reducing interchange rates.
To identify the card type:
Send a
GET https://test-api.payrix.com/tokens?expand[payment][bin][]
request. A successful request returns an array of tokenized payment methods, each of which includes themethod
(card brand),type
(debit, credit, or both), andcategory
(such as personal or corporate card) in apayment.bin
object.In the response, locate the object in the
data
array where thetoken
property matches the card’s token identifier. To qualify for interchange data submission, verify that you meet one of each of the following response values listed in the table:
Required Parameter | Acceptable Values |
---|---|
|
|
|
|
|
Note: The sandbox API only returns a null value. |
Tip
You can also view a card type, BIN, and additional card information in the Portal for previous transactions through the Payment Details tab on the Transaction Details page for the associated card type.
Submit Level 2 and Level 3 Data
You have multiple methods for submitting Level 2 or Level 3 data. Read through the basic methods in the following sections to find the best workflow for your business.
Portal
The Portal offers a simple way to manually enter and submit Level 2 and Level 3 values with payment transactions. Read the following steps to learn more:
API
The Payrix Pro API provides a straightforward method of submitting Level 2 and Level 3 data values alongside transactions. Read the following information to learn more:
PayFields
PayFields is a unique offering that seamlessly integrates a payment gateway into your existing HTML website package and eliminates PCI Compliance risk. You can submit Level 2 and Level 3 data values by adding new fields. Read the following information to learn more: