Level 2 & 3 Data

Summary of Level 2 and 3 Data Elements

Invoice & Level 2 Data – Visa and MasterCard

  • Invoice Number - The invoice number may be up to 50 characters of free text, and it is intended to relate to your accounting or product management system to reference the transactionto an invoice in your system.
  • Customer Reference ID - The customer reference ID may be up to 50 characters of free text, and it should be given to you by your customer. This value is used by the customer, or the customer's accountant, to relate this transaction to a specific employee or representative in the customer's organization that authorized the transaction.
  • Local Tax - The local tax value may be up to 12 numeric characters, and it is the amount of local tax that was charged/included in the transaction. The default value is 0. Please enter 0 or a negative number to indicate tax exempt.
  • National Tax - The national tax value may be up to 12 numeric characters, and it is the amount of national tax that was charged/included in the transaction. If the transaction was tax exempt, enter 0 or a negative number. Generally, national tax only applies to orders that are shipped to a country that charges a regional/local tax and a national/value added tax.

Visa Enhanced Data 

  • Merchant Tax ID - The merchant tax ID may be up to 20 characters of free text. The value entered into this field should be the merchant's Tax ID.
  • Customer Tax ID - The customer tax ID may be up to 13 characters of free text. The value entered into this field should be the customer's Tax ID.
  • Discount Amount - The discount amount may contain up to 12 numeric digits and should represent the value that was discount from the original transaction amount to determine the actual transaction amount.
  • Commodity Code - The commodity code may be up to 4 characters of free text. The value entered into this field should be the international description code of the overall goods or services being supplied. Your merchant acquiring institution should provide you an updated list of currently defined MCC or SIC values.
  • Freight Amount - The freight amount may be up to 12 numeric characters. The amount of freight/shipping costs included in the transaction amount should be entered into this field.
  • Duty Amount - The duty amount may be up to 12 numeric characters. The amount of costs associated with importing the product into the customer's country should be entered into this field.
  • Destination Zip - The destination zip may contain up to 9 numeric characters, and it is intended to represent where the product is being shipped to.
  • Source Zip - The source zip may contain up to 9 numeric characters, and it is intended to represent where the product is being shipped from.
  • Destination Country - The destination country may be selected from the menu, and it is intended to represent the country where the product is being shipped to.
  • Addtnl Tax (Freight) - The additional tax may contain up to 12 numeric characters, and it is intended to represent the tax amount referenced in the transaction associated with shipping or freight costs.
  • Addtnl Tax Rate - The additional tax rate indicator may contain up to 4 numeric characters, and it is intended to represent the rate used to calculate the VAT Tax amount.

Visa Line Item Record

  • Commodity Code - The commodity code may contain up to 12 characters of free text. The value entered into this field should be the international description code of the overall goods or services being supplied. Your merchant acquiring institution should provide you an updated list of currently defined codes.
  • Description - The description may contain up to 35 characters of free text, and it is intended to describe the product referenced in this line item record.
  • Product Code - The product code may contain up to 12 characters of free text, and it is intended to be the identifier of this product with in your accounting or product management system.
  • Quantity - The quantity may contain up to 12 numeric characters. This is the number/count of this specific product was included in the transaction.
  • Unit Measure/Code - The unit measure/code may contain up to 12 characters of free text. This is the unit of measure (i.e. Gallons, Pounds, Liters, Ounces, Each, etc.) that is used to quantity each number/count in the quantity value.
  • Unit Cost - The unit cost may contain up to 12 numeric digits. This is the cost per each quantity of the product/service referenced in this line item record.
  • Addtnl Tax Amount - The additional tax amount may contain up to 12 numeric characters, and it is intended to identify the tax amount collected in reference to this line item record.
  • Addtnl Tax Rate - The additional tax rate may contain up to 4 numeric characters, and it is intended to be the rate of which the tax amount was reported in the Tax Amount field.
  • Discount - The discount may contain up to 12 numeric characters, and it is intended to report the full discount amount applied to the transaction in reference to this product.
  • Item Total Amount - The item total amount may contain up to 12 numeric characters, and it is intended to report the full amount of the transaction referenced to this product. It is generally calculated as price multiplied by quantity.

MasterCard Enhanced Data

  • Freight Amount - The freight amount may be up to 12 numeric characters. The amount of freight/shipping costs included in the transaction amount should be entered into this field.
  • Duty Amount - The duty amount may be up to 12 numeric characters. The amount of costs associated with importing the product into the customer's country should be entered into this field.
  • Destination Zip - The destination zip may contain up to 9 numeric characters, and it is intended to represent where the product is being shipped to.
  • Source Zip - The source zip may contain up to 9 numeric characters, and it is intended to represent where the product is being shipped from.
  • Destination Country - The destination country may be selected from the menu, and it is intended to represent the country where the product is being shipped to.
  • Addtnl Tax Indicator - The additional tax indicator may be selected from the menu, and it is intended to represent whether the transaction amount included more than one tax amount in the event that the destination country has multiple taxes that apply to this transaction.
  • Addtnl Tax Amount - The additional tax amount may contain up to 9 numeric characters, and it is intended to represent the additional tax amount in the event that the destination country has multiple taxes that apply to this transaction.

MasterCard Line Item Record

  • Description - The description may contain up to 35 characters of free text, and it is intended to describe the product referenced in this line item record.
  • Product Code - The product code may contain up to 12 characters of free text, and it is intended to be the identifier of this product with in your accounting or product management system.
  • Quantity - The quantity may contain up to 12 numeric characters. This is the number/count of this specific product was included in the transaction.
  • Unit Measure/Code - The unit measure/code may contain up to 12 characters of free text. This is the unit of measure (i.e. Gallons, Pounds, Liters, Ounces, Each, etc.) that is used to quantity each number/count in the quantity value.
  • Alt. Tax ID - The alternate tax ID may contain up to 15 characters of free text, and it is intended to be your Tax ID.
  • Addntl Tax Rate - The tax rate may contain up to 4 numeric characters, and it is intended to be the rate of which the tax amount was reported in the Tax Amount field.
  • Addntl Tax Type - The tax type may contain up to 4 characters of free text, and it is intended to identify the type of tax being reported in the Tax Amount field. Addntl Tax Amount - The tax amount may contain up to 12 numeric characters, and it is intended to identify the additional tax amount not reported in the Local Tax field.
  • Discount Indicator - The discount indicator is used to specify if this line item netted a debit or a credit/discount to the total transaction amount.
  • Net/Gross Indicator - The net/gross indicator is used to specify whether or not the transaction amount includes tax.
  • Extended Amount - The extended amount may contain up to 9 numeric characters, and it is intended to report the full amount of the transaction referenced to this product. It is generally calculated as price multiplied by quantity.
  • Debit/Credit Indicator - The debit/credit indicator may be selected from the menu to indicate whether the Extended Amount has a debit or a credit impact on the transaction amount.
  • Discount - The discount may contain up to 12 numeric characters, and it is intended to report the full discount amount applied to the transaction in reference to this product.
  • Discount Rate - The discount rate may contain up to 5 characters of free text, and it is intended to report the rate at which the discount was calculated.