level-3-data-item

Contains Level 2/3 data properties for each item purchased

📘

Notes

  • A maximum of 97 level-3-data-item containers is supported. If you send more than 97 in the request, the first 97 will be accepted and the rest will be ignored.
  • While all level-3-data-item 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
commodity-codestringCommodity 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
discount-amountdecimalDiscount amount applied to item
Max length: Mastercard: 9, Visa: 12
discount-indicatorstringIndicates whether item amount is discounted
Max length: 1
Possible values:
Y — Item amount is discounted.
N — Item amount is not discounted.
gross-net-indicatorstringIndicates 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.
item-quantitydecimalItem quantity purchased
Max length: 12
line-item-totaldecimalTotal item amount
Max length: Mastercard: 9, Visa: 12
product-codestringProduct code for item
Max length: 12
tax-amountdecimalTax amount for item
Max length: Mastercard: 9, Visa: 12
tax-ratedecimalTax rate applied to item
Max length: Mastercard: 5, Visa: 4
tax-typestringType of tax being applied
Max length: 4
unit-costdecimalUnit cost
Max length:
unit-of-measurestringUnit of measure
Max length: Mastercard: 3, Visa: 12

Response


Property NameTypeDescription
commodity-codestringCommodity code used to classify item.
descriptionstringItem description.
discount-amountdecimalDiscount amount applied to item.
discount-indicatorstringIndicates whether item amount is discounted.
Possible values:
Y - Item amount is discounted.
N - Item amount is not discounted.
gross-net-indicatorstringIndicates whether tax is included in item amount
Possible values:
Y - Tax is included in item amount
N - Tax is not included in item amount.
item-quantitydecimalItem quantity purchased.
line-item-totaldecimalTotal item amount.
product-codestringProduct code for item.
tax-amountdecimalTax amount for item.
tax-ratedecimalTax rate applied to item.
tax-typestringType of tax being applied.
unit-costdecimalUnit cost.
unit-of-measurestringUnit of measure.