{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"level-3-data-item","type":"basic","slug":"level-3-data-item","excerpt":"Contains Level 2/3 data properties for each item purchased","body":"[block:callout]\n{\n \"type\": \"info\",\n \"body\": \"* 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.\\n* 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](/docs/level-23-data) for complete details.\",\n \"title\": \"Notes\"\n}\n[/block]\n###Request\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Property Name\",\n \"h-1\": \"Type\",\n \"h-2\": \"Description\",\n \"h-3\": \"\",\n \"0-0\": \"`line-item-total`\",\n \"0-1\": \"*decimal*\",\n \"0-2\": \"Total item amount\\nMax length:\\n* Mastercard: 9\\n* Visa: 12\",\n \"0-3\": \"Total item amount.\",\n \"1-0\": \"`commodity-code`\",\n \"2-0\": \"`description`\",\n \"3-0\": \"`discount-amount`\",\n \"4-0\": \"`discount-indicator`\",\n \"5-0\": \"`gross-net-indicator`\",\n \"6-0\": \"`product-code`\",\n \"7-0\": \"`item-quantity`\",\n \"8-0\": \"`tax-amount`\",\n \"9-0\": \"`tax-rate`\",\n \"10-0\": \"`tax-type`\",\n \"11-0\": \"`unit-cost`\",\n \"12-0\": \"`unit-of-measure`\",\n \"1-1\": \"*string*\",\n \"2-1\": \"*string*\",\n \"3-1\": \"*decimal*\",\n \"7-1\": \"*decimal*\",\n \"8-1\": \"*decimal*\",\n \"9-1\": \"*decimal*\",\n \"11-1\": \"*decimal*\",\n \"4-1\": \"*string*\",\n \"5-1\": \"*string*\",\n \"6-1\": \"*string*\",\n \"10-1\": \"*string*\",\n \"12-1\": \"*string*\",\n \"1-2\": \"Commodity code used to classify item\\nMax length: 12\\n>**Important**\\n>For Visa, the commodity code must be numeric and cannot be all zeros or the transaction will fail.\",\n \"2-2\": \"Item description\\nMax length: \\n* Amex: 40\\n* Mastercard: 35\\n* Visa: 26\",\n \"3-2\": \"Discount amount applied to item\\nMax length: \\n* Mastercard: 9\\n* Visa: 12\",\n \"4-2\": \"Indicates whether item amount is discounted\\nMax length: 1\\n\\nPossible values: \\n* **Y** — Item amount is discounted. \\n* **N** — Item amount is not discounted.\",\n \"5-2\": \"Indicates whether tax is included in item amount\\nMax length: 1\\n\\nPossible values: \\n* **Y** — Tax is included in item amount \\n* **N** — Tax is not included in item amount.\",\n \"6-2\": \"Product code for item\\nMax length: 12\",\n \"7-2\": \"Item quantity purchased\\nMax length: 12\",\n \"8-2\": \"Tax amount for item\\nMax length:\\n* Mastercard: 9\\n* Visa: 12\",\n \"9-2\": \"Tax rate applied to item\\nMax length:\\n* Mastercard: 5\\n* Visa: 4\",\n \"10-2\": \"Type of tax being applied\\nMax length: 4\",\n \"11-2\": \"Unit cost\\nMax length:\",\n \"12-2\": \"Unit of measure\\nMax length:\\n* Mastercard: 3\\n* Visa: 12\",\n \"1-3\": \"\",\n \"2-3\": \"\",\n \"3-3\": \"\",\n \"4-3\": \"\",\n \"5-3\": \"\",\n \"6-3\": \"\",\n \"7-3\": \"\",\n \"8-3\": \"\",\n \"9-3\": \"\",\n \"10-3\": \"\",\n \"11-3\": \"\",\n \"12-3\": \"\"\n },\n \"cols\": 3,\n \"rows\": 13\n}\n[/block]\n###Response\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Property Name\",\n \"h-1\": \"Type\",\n \"h-3\": \"Description\",\n \"0-0\": \"`line-item-total`\",\n \"0-1\": \"*decimal*\",\n \"0-2\": \"Total item amount.\",\n \"0-3\": \"Total item amount.\",\n \"1-0\": \"`commodity-code`\",\n \"2-0\": \"`description`\",\n \"3-0\": \"`discount-amount`\",\n \"4-0\": \"`discount-indicator`\",\n \"5-0\": \"`gross-net-indicator`\",\n \"6-0\": \"`product-code`\",\n \"7-0\": \"`item-quantity`\",\n \"8-0\": \"`tax-amount`\",\n \"9-0\": \"`tax-rate`\",\n \"10-0\": \"`tax-type`\",\n \"11-0\": \"`unit-cost`\",\n \"12-0\": \"`unit-of-measure`\",\n \"1-1\": \"*string*\",\n \"2-1\": \"*string*\",\n \"3-1\": \"*decimal*\",\n \"7-1\": \"*decimal*\",\n \"8-1\": \"*decimal*\",\n \"9-1\": \"*decimal*\",\n \"11-1\": \"*decimal*\",\n \"4-1\": \"*string*\",\n \"5-1\": \"*string*\",\n \"6-1\": \"*string*\",\n \"10-1\": \"*string*\",\n \"12-1\": \"*string*\",\n \"1-2\": \"Commodity code used to classify item.\",\n \"2-2\": \"Item description.\",\n \"3-2\": \"Discount amount applied to item.\",\n \"4-2\": \"Indicates whether item amount is discounted. \\n\\nPossible values: \\n* **Y** - Item amount is discounted. \\n* **N** - Item amount is not discounted.\",\n \"5-2\": \"Indicates whether tax is included in item amount \\n\\nPossible values: \\n* **Y** - Tax is included in item amount \\n* **N** - Tax is not included in item amount.\",\n \"6-2\": \"Product code for item.\",\n \"7-2\": \"Item quantity purchased.\",\n \"8-2\": \"Tax amount for item.\",\n \"9-2\": \"Tax rate applied to item.\",\n \"10-2\": \"Type of tax being applied.\",\n \"11-2\": \"Unit cost.\",\n \"12-2\": \"Unit of measure.\",\n \"h-2\": \"Description\"\n },\n \"cols\": 3,\n \"rows\": 13\n}\n[/block]","updates":[],"order":27,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"61a5208deadb750070998eb4","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Resources","slug":"resources","order":16,"from_sync":false,"reference":false,"_id":"61a5208deadb750070998e93","version":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:20:51.519Z","__v":0},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["61a5208deadb750070998e87","61a5208deadb750070998e88","61a5208deadb750070998e89","61a5208deadb750070998e8a","61a5208deadb750070998e8b","61a5208deadb750070998e8c","61a5208deadb750070998e8d","61a5208deadb750070998e8e","61a5208deadb750070998e8f","61a5208deadb750070998e90","61a5208deadb750070998e91","61a5208deadb750070998e92","61a5208deadb750070998e93","61a5208deadb750070998e94","61a5208deadb750070998e95","61a5208deadb750070998e96","61a5208deadb750070998e97","61a5208deadb750070998e98","61a5208deadb750070998e99","61a5208deadb750070998e9a"],"_id":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60fed269718a45001c25b4a0","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"createdAt":"2018-02-23T14:19:23.173Z","githubsync":"","__v":0}
level-3-data-item
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.
line-item-total
decimal
Total item amount
Max length:
- Mastercard: 9
- Visa: 12
commodity-code
string
Commodity 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.
description
string
Item description
Max length:
- Amex: 40
- Mastercard: 35
- Visa: 26
discount-amount
decimal
Discount amount applied to item
Max length:
- Mastercard: 9
- Visa: 12
discount-indicator
string
Indicates whether item amount is discounted
Max length: 1
Possible values:
- Y — Item amount is discounted.
- N — Item amount is not discounted.
gross-net-indicator
string
Indicates 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-code
string
Product code for item
Max length: 12
item-quantity
decimal
Item quantity purchased
Max length: 12
tax-amount
decimal
Tax amount for item
Max length:
- Mastercard: 9
- Visa: 12
tax-rate
decimal
Tax rate applied to item
Max length:
- Mastercard: 5
- Visa: 4
tax-type
string
Type of tax being applied
Max length: 4
unit-cost
decimal
Unit cost
Max length:
unit-of-measure
string
Unit of measure
Max length:
- Mastercard: 3
- Visa: 12
line-item-total
decimal
Total item amount.
commodity-code
string
Commodity code used to classify item.
description
string
Item description.
discount-amount
decimal
Discount amount applied to item.
discount-indicator
string
Indicates whether item amount is discounted.
Possible values:
- Y - Item amount is discounted.
- N - Item amount is not discounted.
gross-net-indicator
string
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.
product-code
string
Product code for item.
item-quantity
decimal
Item quantity purchased.
tax-amount
decimal
Tax amount for item.
tax-rate
decimal
Tax rate applied to item.
tax-type
string
Type of tax being applied.
unit-cost
decimal
Unit cost.
unit-of-measure
string
Unit of measure.