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
line-item-totaldecimalTotal item amount
Max length:
Mastercard: 9
Visa: 12
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.
product-codestringProduct code for item
Max length: 12
item-quantitydecimalItem quantity purchased
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
line-item-totaldecimalTotal item amount.
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.
product-codestringProduct code for item.
item-quantitydecimalItem quantity purchased.
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.