{"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\": \"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}\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":24,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed5174637c3c607440c09b6","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Resources","slug":"resources","order":14,"from_sync":false,"reference":false,"_id":"5ed5174637c3c607440c0997","version":"5ed5174637c3c607440c0a3c","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.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed5174637c3c607440c098b","5ed5174637c3c607440c098c","5ed5174637c3c607440c098d","5ed5174637c3c607440c098e","5ed5174637c3c607440c098f","5ed5174637c3c607440c0990","5ed5174637c3c607440c0991","5ed5174637c3c607440c0992","5ed5174637c3c607440c0993","5ed5174637c3c607440c0994","5ed5174637c3c607440c0995","5ed5174637c3c607440c0996","5ed5174637c3c607440c0997","5ed5174637c3c607440c0998","5ed5174637c3c607440c0999","5ed5174637c3c607440c099a","5ed5174637c3c607440c099b","5ed5174637c3c607440c099c"],"_id":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3a02fb6fb40050cb3c15","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"createdAt":"2018-02-23T14:19:23.173Z","githubsync":"","__v":0}

Payment API (XML)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Local Bank Transfer transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

Mobile SDK

level-3-data-item

Contains Level 2/3 data properties for each item purchased

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 Name
Type
Description

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

Response

Property Name
Type
Description

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.