level3DataItems

Contains Level 2/3 data properties for each item purchased

📘

Notes

  • A maximum of 97 line items is supported within level3DataItems. If you send more than 97 line items in the request, the first 97 will be accepted and the rest will be ignored.

  • While all level3DataItems properties are optional in the request, each data level (such as Level 2 and Level 3) has specific requirements. See the Level 2/3 Data guide for complete details.

Request

Property NameTypeDescription
commodityCodestringCommodity code used to classify item
Max length: 12

Important
For Visa, the commodity code must be numeric and cannot be all zeros or the transaction will fail.

descriptionstringItem description

Max length:
  • Amex: 40
  • Mastercard: 35
  • Visa: 26
discountAmountdecimalDiscount amount applied to item

Max length:
  • Mastercard: 9
  • Visa: 12
discountIndicatorstringIndicates whether item amount is discounted
Max length: 1

Possible values:
  • Y — Item amount is discounted.
  • N — Item amount is not discounted.
grossNetIndicatorstringIndicates whether tax is included in item amount
Max length: 1

Possible values:
  • Y — Tax is included in item amount
  • N — Tax is not included in item amount.
itemQuantitydecimalItem quantity purchased
Max length: 12
lineItemTotaldecimalTotal item amount

Max length:
  • Mastercard: 9
  • Visa: 12
productCodestringProduct code for item
Max length: 12
taxAmountdecimalTax amount for item

Max length:
  • Mastercard: 9
  • Visa: 12
taxRatedecimalTax rate applied to item

Max length:
  • Mastercard: 5
  • Visa: 4
taxTypestringType of tax being applied
Max length: 4
unitCostdecimalUnit cost
Max length: 12
unitOfMeasurestringUnit of measure

Max length:
  • Mastercard: 3
  • Visa: 12

Response

Property NameTypeDescription
commodityCodestringCommodity code used to classify item.
descriptionstringItem description.
discountAmountdecimalDiscount amount applied to item.
discountIndicatorstring

Indicates whether item amount is discounted.

Possible values:
  • Y - Item amount is discounted.
  • N - Item amount is not discounted.
grossNetIndicatorstring

Indicates whether tax is included in item amount

Possible values:
  • Y - Tax is included in item amount
  • N - Tax is not included in item amount.
itemQuantitydecimalItem quantity purchased.
lineItemTotaldecimalTotal item amount.
productCodestringProduct code for item.
taxAmountdecimalTax amount for item.
taxRatedecimalTax rate applied to item.
taxTypestringType of tax being applied.
unitCostdecimalUnit cost.
unitOfMeasurestringUnit of measure.