With credit card transactions, different levels of data submission are critical for businesses engaged in different types of transactions. Referrers and Merchants can receive up to 40-100 basis points of reduced fees on their qualifying business and commercial card transactions.
There are three levels of interchange data submission available:
Level |
1 | Basic transaction data like card number, expiration date, CVV, and transaction amount that is required for standard business-to-consumer (B2C) transactions and |
provide standard interchange rates. |
Level |
2 | More detailed transaction data, like a sales tax |
and order number, is required for B2B transactions and |
can provide lower interchange rates. |
Level |
3 | Comprehensive transaction |
data like line item details and shipping |
for B2B transactions can qualify for the lowest interchange rates. |
Major card brands Visa & MasterCard each have specific requirements that merchants must adhere to to offer them the best interchange rates. American Express and Discover do not accept direct Level II 2 or Level III 3 data submissions for lower interchange rates at this time.Below is a breakdown of the key data required for Level II and Level III data submission for
Tip |
---|
Tip: While not a requirement, it is recommended to submit the previous level of interchange data when submitting the following level. Example: When submitting Level 3 data, all Level 1 and Level 2 data requirements are already met to ensure the most visibility for Level 3 interchange rates. |
Below is a breakdown of the key data required for Level 2 and Level 3 data submission for each card brand.
Info |
---|
Note: Each additional level of data submission, Level I to Level II to Level III data, requires all data from the previous level in addition to the new data required. Example: In order to submit Level III data, all Level I and Level II data requirements must already be met to qualify for Level III interchange rates. |
Level I Interchange Data Requirements
All transactions, regardless of card brand, must meet these data requirements in order to qualify for basic interchange or Level I:
Merchant & Transaction Information - Basic data provided about the Merchant and Transaction, including:
...
Merchant Name
...
The name of the Merchant business selling products or services.
...
Transaction Date
...
The date that the transaction took place.
...
Transaction Amount
...
The total amount of the transaction charged to the customer.
Customer / Cardholder Information - Essential customer and card data used to pay, including:
...
Customer Zip Code
...
The billing zip code on file with the customer’s credit card company.
...
Customer Billing Address
...
The full billing address on file with the customer’s credit card company.
...
Credit Card Number
...
The 15 (AMEX) or 16-digit credit card number shown on the customer’s card.
...
Card Expiration Date
...
The 4-digit, MMYY-format expiration date shown on the customer’s card.
...
Level 1 Interchange Data Requirements
All transactions, regardless of card brand, must meet these data requirements to qualify for basic interchange or Level 1:
Merchant & Transaction Information - Basic data provided about the Merchant and Transaction, including:
Merchant Name | The name of the Merchant business selling products or services. |
Transaction Date | The date that the transaction took place. |
Transaction Amount | The total amount of the transaction charged to the customer. |
Customer / Cardholder Information - Essential customer and card data used to pay, including:
Customer Zip Code | The billing zip code on file with the customer’s credit card company. |
Customer Billing Address | The full billing address on file with the customer’s credit card company. |
Credit Card Number | The 15 (AMEX) or 16-digit credit card number shown on the customer’s card. |
Card Expiration Date | The 4-digit, MMYY-format expiration date shown on the customer’s card. |
Card CVV | The 3 or 4-digit security code shown on the customer’s card. |
...
Commodity Codes
The Commodity Code must be submitted in numeric-only formatting to meet requirements. Merchants should utilize the National Institute of Governmental Purchasings' (NIGP) Commodity Codes.
Info |
---|
Info | ||||
---|---|---|---|---|
A partial list of 7-digit NIGP commodity codes is available here:
|
...
Level 2 and 3 Interchange Data Requirements
Each card brand will feature its own list of requirements necessary to receive interchange rates by using Level II 2 or Level III 3 data to qualify on its card network. Each major card brand - Visa, MasterCard, American Express, and Discover - has been listed below with individual details to clearly explain their requirements.
Once you are familiar with these requirements, visit <<Submit Level II & III interchange data article>> Submit Interchange Data with Transactions below to learn the different methods available to submit this data.
Tip |
---|
Tip: For developers and Portal users, we recommend using Visa’s Level II 2 and Level III 3 requirements as your data submission foundation for Level II 2 and Level II 1 submission for any card brand. Visa’s stringent standards cover all necessary elements for detailed transaction reporting. |
Note |
---|
Warning: For all ‘tax’ amount values, ensure the amount always corresponds to your local state or province regulations to ensure tax compliance. |
Visa
In addition to the parameter qualifications below, Visa also requires the following conditions to be met from Merchants before they can submit Level II or Level III data for lower interchange rates:
Merchants must process 1 to 6 million Visa transactions per year.
Merchants must process between $20,000 and $1,000,000 in e-commerce transactions per year.
Merchants must submit the following forms to the Visa Verification team:
Annual Attestation of Compliance (AOC)
Annual Self-Assessment Questionnaire (SAQ)
Quarterly Network Scan by an Approved Scan Vendor (ASV2)
...
Note: If you choose to optionally submit Level 2 data with Level 3 data, the tax rate must be set between 0.1% & 22% of the transaction amount when the tax amount is greater than $0.00.
Visa
Read more information about Visa requirements below:
Expand | ||
---|---|---|
| ||
The following card types can be used for Level II 2 data submission:
In addition to the above, the following card types can be used for Level III 3 data submission:
|
Expand | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
Level II 2 data must include all Level I 1 data requirements in addition to the requirements listed below. Sales Tax and Order Information - Sales tax information for each transaction including:
Merchant Information - Details about the Merchant selling the product or service items including: Customer Code The unique identifier assigned to customers or entities within the Merchant’s records. Merchant Zip Code The zip code where the Merchant’s business is located. | The tax identification number issued to the Merchant by their governmental tax agencyMerchant TIN
|
Expand | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||
title | Visa - AdditionalLevel III 3 data must include all Level II 2 data requirements in addition to the requirements listed below. Order (Line) Item Details - Must provide detailed information for each item listed in a transaction including:
Discount, Shipping & Duty - Must provide shipping, duty, and tax information (if applicable) including:
| ||||||||||||||||||||||||||||||||||||||||
Expand | |||||||||||||||||||||||||||||||||||||||||
|
Expand | ||
---|---|---|
| ||
In addition to the interchange data requirements above, the Visa card network has specific additional requirements to qualify:
|
Expand | ||
---|---|---|
| ||
Large Ticket transactions refer to transactions with a larger total dollar amount. Based Your interchange rate may change based on the transaction amount , your interchange rate may change to offer better pricing from Visa’s large ticket program for high-dollar-value transactions. In addition to the data requirements above, the Visa card network has specific additional requirements to qualify for Large Ticket interchange pricing:
|
Expand | |||||
---|---|---|---|---|---|
| The |||||
|
...
title | MasterCard - Level III Data Requirements |
---|
Level III data must include all Level II data requirements in addition to the requirements listed below.
Line Item Details - Must provide detailed information for each item listed in a transaction including:
...
Discount Amount
...
Monetary reductions applied to the transaction total.
...
Discount Per Line Item
...
Monetary reductions applied to the product or service price for the line item.
...
Item Description
...
A detailed description of the product or service sold.
...
Line Item Total
...
Total transaction line item cost, calculated with quantity, unit price, discounts, tax, and shipping.
...
Product Code
...
A unique identifier used by the Merchant business to identify the specific product.
...
Quantity
...
The number of units sold.
...
Unit of Measure
...
A standardized unit used to quantify the quantity of the product or service.
Note |
---|
Warning: The following card types are ineligible for Level III interchange with MasterCard:
|
Expand | ||
---|---|---|
| ||
In addition to the interchange data requirements above, the MasterCard card network has specific additional requirements to qualify:
|
Expand | ||
---|---|---|
| ||
Large Ticket transactions refer to transactions with a larger total dollar amount. Based on the transaction amount, your interchange rate may change to offer better pricing from MasterCard’s large ticket program for high-dollar-value transactions. In addition to the data requirements above, the MasterCard network has specific additional requirements to qualify for Large Ticket interchange pricing:
|
Expand | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||
The following Merchant Commercial Code (MCC) types are disqualified from Level II or Level III data submission for interchange rate improvements: MasterCard Non-Compliant MCCs List: Non-Compliant MCCs Description of Merchant Business Type 3000–3999 Airlines/Car Rental Companies/Hotels
|
MasterCard
In addition to the parameter qualifications below, MasterCard also requires the following conditions to be met from Merchants before they can submit Level II or Level III data for lower interchange rates:
Merchants must process a combined total of 1 to 6 million MasterCard & Maestro transactions per year.
Merchants must process between $20,000 and $1,000,000 in e-commerce transactions per year.
Merchants must submit the following forms to the MasterCard:
Annual Attestation of Compliance (AOC)
Annual Self-Assessment Questionnaire (SAQ)
Quarterly Network Scan by an Approved Scan Vendor (ASV2)
Read more information about MasterCard requirements below:
...
title | MasterCard - Qualifying Card Types for Interchange Data Submission |
---|
The following card types can be used for Level II data submission:
Corporate Purchasing
Business Credit
Enhanced Business Credit
Signature Business Credit
In addition to the above, the following card types can be used for Level III data submission:
Corporate Credit
Purchasing Credit
Note |
---|
Commercial Prepaid card type is not eligible. |
Note |
---|
Warning: The following card types are ineligible for Level III data submission with MasterCard:
|
...
title | MasterCard - Level II Data Requirements |
---|
Level II data must include all Level I data requirements in addition to the requirements listed below.
Sales Tax Information - Sales tax information for each transaction including:
...
Sales Tax Amount
...
The total amount of sales tax applied to the transaction.
Note |
---|
Warning: The tax amount must be between 0.1% - 30% of the payment total to qualify. This is submitted using either a Sale or a Capture transaction type. |
...
Sales Tax Indicator
...
Specify whether sales tax is included in the transaction amount or not.
...
Order Number
...
A unique identifier used by the merchant to locate the specific transaction information.
Note: “Order Number” and “Invoice Number” are interchangeable terms for Level II and Level III data submission.
Merchant Information - Details about the Merchant selling the product or service items including:
...
Customer Code
...
The unique identifier assigned to customers or entities within the Merchant’s records.
...
Merchant TIN
...
The tax identification number issued to the Merchant by their governmental tax agency.
|
...
MasterCard
Read more information about MasterCard requirements below:
Expand | ||||
---|---|---|---|---|
| ||||
The following card types can be used for Level 2 data submission:
Note: MasterCard uses the term “Data Rate 2 and 3” to refer to Level 2 and Level 3 interchange data when referring to corporate/business purchases and cards. In addition to the above, the following card types can be used for Level 3 data submission:
|
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Level 2 data must include all Level 1 data requirements in addition to the requirements listed below. Sales Tax Information - Sales tax information for each transaction including:
|
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
Level 3 data must include all Level 2 data requirements in addition to the requirements listed below. Item Details - Must provide detailed information for each item listed in a transaction including:
Note: When submitting a Level 3 transaction, the tax amount must be a percent between 0.1% & 30% of the transaction; it cannot be zero unless tax-exempt status is enabled by the Facilitator.
|
Expand | ||
---|---|---|
| ||
In addition to the interchange data requirements above, the MasterCard card network has specific additional requirements to qualify:
|
Expand | ||
---|---|---|
| ||
Large Ticket transactions refer to transactions with a larger total dollar amount. Your interchange rate may change based on the transaction amount to offer better pricing from MasterCard’s large ticket program for high-dollar-value transactions. In addition to the data requirements above, the MasterCard network has specific additional requirements to qualify for Large Ticket interchange pricing:
|
Expand | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||
MasterCard Non-Compliant MCCs List:
|
...
American Express
...
Merchants processing American Express transactions are required to obtain pre-approval before initiating Level II data processing. Level II data parameters from Visa or MasterCard would apply here.
To receive approval, Merchants must submit a “Level 2 Merchant’s Validation Documentation” which includes summaries from Quarterly Network Scan and a completed PCI Self Assessment Questionaire. Once granted, American Express accepts both Level I and Level II data, offering Level II interchange rates.
Visit the American Express US Data Security site for more information.
Warning |
---|
Unavailable: American Express does not offer discounts or changes in interchanges rates for Level III data submissions |
Discover
Warning |
---|
Unavailable: American Express does not offer any discounts or changes in interchanges rates for Level II or Level III data submissions. |
Submit Interchange Data with Transactions
To take advantage of lower interchange rates, this Level II and Level III data must be submitted alongside your transaction. This ensures the customer’s card brand network is able to receive and assess the data to determine which interchange rate the transaction will receive.
Info |
---|
Before you begin, we recommend checking each card’s eligibility for Level II and Level III processing as American Express and Discover don’t offer direct data submission options for Level II or III to qualify for lower interchange rates. A simple query shown below will quickly identify the card type:
The response will display the method (card brand), type (debit, credit or both), and card category (personal, corporate card, etc.), which will allow you to know before submitting the additional data, if the card brand network supports lower interchange rates or Level II or Level III data submissions. |
There are multiple methods to submit Level II or Level III data, read through the basic methods below to find the best workflow for your business:
Portal
The Portal offers a very simple way to manually enter and submit Level II and Level III values with payment transactions. Read the steps below to learn more:
Expand | ||
---|---|---|
| ||
To submit Level II transaction data using the Create Payments page:
Click Process Payment to complete the submission. |
Expand | ||
---|---|---|
| ||
To submit Level III transaction data using the Create Payments page:
Click Process Payment to complete the submission. |
API
The Payrix API provides a straightforward method of submitting Level II and Level III data values alongside transactions. Read the information below to learn more.
...
title | Submit Level II data using the Payrix API. |
---|
To submit Level II transaction data using the /txns
Payrix API endpoint, send the following request:
Code Block |
---|
POST https://test-api.payrix.com/txns |
Code Block | ||
---|---|---|
| ||
{
"merchant":"{yourMerchantID}",
"payment":{
"number":"{customerCardNumber}",
"cvv":"{customerCardCVV}"
}
"expiration":"MMYY",
"type":2,
"order":"INVOICE#1",
"total":7799,
"tax":100,
} |
...
Required Parameters
...
Type
...
Description
...
Valid Values / Format
...
merchant
...
string
...
The identifier of the Merchant associated with this Transaction.
...
payment
...
object
...
The payment method associated with this Transaction, including the card details.
...
number
...
number
...
For credit payment method, the card number of the credit card associated with this Transaction.
For eCheck payment method, the bank account number is associated with this Transaction.
...
cvv
...
integer
...
The Card Verification Value (CVV) number of the credit card associated with this Transaction.
...
This field is expressed as a 3-digit integer.
...
expiration
...
number
...
The expiration date of the credit card associated with this Transaction.
...
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, '0623' for June 2023.
...
type
...
integer
...
The type of Transaction.
...
1
- Credit Card Only: Sale Transaction. Processes a sale and charges the customer.
2
- Credit Card Only: Auth Transaction. Authorizes and holds the requested total on the credit card.
3
- Credit Card Only: Capture Transaction. Finalizes a prior Auth Transaction and charges the customer.
4
- Credit Card Only: Reverse Authorization. Reverses a prior Auth or Sale Transaction and releases the credit hold.
5
- Credit Card Only: Refund Transaction. Refunds a prior Capture or Sale Transaction (total may be specified for a partial refund).
7
- eCheck Only: eCheck Sale Transaction. Sale Transaction for eCheck payment.
8
- eCheck Only: eCheck Refund Transaction. Refund Transaction for prior eCheck Sale Transaction.
11
- eCheck Only: eCheck Redeposit Transaction. Attempt to redeposit a prior failed eCheck Sale Transaction.
12
- eCheck Only: eCheck Account Verification Transaction. Attempt to verify eCheck payment details.
...
total
...
number
...
The total amount of this Transaction.
...
This field is specified as an integer in cents.
...
tax
...
integer
...
The amount of the total sum of this Transaction that is made up of tax.
...
This field is specified as an integer in cents.
...
title | Submit Level III data using the Payrix API. |
---|
To submit Level III transaction data using the /txns
Payrix API endpoint, send the following request:
Code Block | ||
---|---|---|
| ||
{
"merchant":"{yourMerchantID}",
"payment":{
"number":"{customerCardNumber}",
"cvv":"{customerCardCVV}"
}
"expiration":"MMYY",
"type":2,
"order":"INVOICE#1",
"total":7799,
"tax":100,
"items":[
{
"item":"Line Item #1",
"description":"Line Item Description"
"quantity":1,
"price":7799,
"um":"EACH",
"commodityCode":"1111999",
"total":5799,
"discount":-2000,
"productCode":"UPC12345"
},
]
} |
Note: Descriptions for Level II data shown here are available in the Submit Level II data using the Payrix API section above.
...
Required Parameters
...
Type
...
Description
...
Valid Values / Format
...
items
...
array of objects
...
The item or list of items associated with the transaction/order.
...
item
...
string
...
The line item name.
...
description
...
string
...
The line item description.
...
Max length: 500 characters
...
quantity
...
integer
...
The total number of units for the line item.
...
price
...
number
...
The individual line item price.
...
um
...
string
...
The line item units of measure.
Exmaple: “pounds”, “days”, “hours”.
...
Max length: 100 characters
...
commodityCode
...
string
...
The commodity code for this Item.
...
Max length:12 characters
...
total
...
integer
...
The total price for the line item.
...
This field is specified as an integer in cents
...
discount
...
integer
...
The discount for the line item.
...
This field is specified as an integer in cents.
...
productCode
...
string
...
The product code for this Item such as: UPC, catalog number, or inventory number.
PayFields
PayFields is a unique offering that seamlessly integrates a payment gateway into your existing HTML website package and eliminates PCI Compliance risk. Submitting Level II
...
title | Submit Level II data using PayFields. |
---|
Step 1: Under your <script> tag containing PayFields.fields
enter the following to add new Tax and Order fields to the PayFields
Code Block | ||
---|---|---|
| ||
<body>
<div>
<label for="number">Number:</label>
<div id="number"></div>
</div>
<script>
PayFields.fields = [
{type: "number", element: "#number"},
{type: "cvv", element: "#cvv"},
{type: "name", element: "#name"},
{type: "address", element: "#address"},
{type: "expiration", element: "#expiration"}
{type: "tax", element: "#tax"}
{type: "order", element: "#order"}
];
</script>
</body> |
Code Block |
---|
<body>
|
...
language | html |
---|
...
& Discover
There is no additional work or line item data submission required by American Express or Discover.
Both card brands provide lower interchange rates on their respective networks, calculated and adjusted based exclusively on the cardholder’s card type (e.g. business card, corporate card, etc.).