{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"level-3-data","type":"basic","slug":"level-3-data","excerpt":"Contains Level 2/3 data properties for the transaction","body":"[block:callout]\n{\n \"type\": \"info\",\n \"body\": \"While all `level-3-data` 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\": \"`customer-reference-number`\",\n \"0-1\": \"*string*\",\n \"0-2\": \"Reference number used by shopper to track order\\nMax length: 17\",\n \"0-3\": \"\",\n \"1-0\": \"`sales-tax-amount`\",\n \"1-1\": \"*decimal*\",\n \"1-2\": \"Total sales tax amount\\nMax length: 12\",\n \"2-0\": \"`freight-amount`\",\n \"3-0\": \"`duty-amount`\",\n \"4-0\": \"`destination-zip-code`\",\n \"5-0\": \"`destination-country-code`\",\n \"6-0\": \"`ship-from-zip-code`\",\n \"7-0\": \"`discount-amount`\",\n \"8-0\": \"`tax-amount`\",\n \"9-0\": \"`tax-rate`\",\n \"10-0\": \"`level-3-data-item`\",\n \"2-2\": \"Shipping amount\\nMax length:\\n* Mastercard: 9\\n* Visa: 12\",\n \"3-2\": \"Total charges for import/export duties included in transaction\\nMax length:\\n* Mastercard: 9\\n* Visa: 12\",\n \"4-2\": \"Destination zip code\\nMax length: 10\",\n \"5-2\": \"Destination [country code](doc:country-codes)\\nMax length: 3\",\n \"6-2\": \"The zip code of the location from where the items were shipped\\nMax length: 10\",\n \"7-2\": \"Discount amount applied to transaction\\nMax length: 12\",\n \"8-2\": \"Total tax/VAT amount for transaction\\nMax length: 12\",\n \"9-2\": \"Tax/VAT rate applied to transaction\\nMax length: 4\",\n \"10-2\": \"Container of [level-3-data-item](doc:level-3-data-item) properties. \\n\\n*May appear multiple times in request*\",\n \"2-1\": \"*decimal*\",\n \"3-1\": \"*decimal*\",\n \"4-1\": \"*string*\",\n \"5-1\": \"*string*\",\n \"6-1\": \"*string*\",\n \"7-1\": \"*decimal*\",\n \"8-1\": \"*decimal*\",\n \"9-1\": \"*decimal*\",\n \"10-1\": \"*container*\",\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 },\n \"cols\": 3,\n \"rows\": 11\n}\n[/block]\n###Response\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Property Name\",\n \"h-1\": \"Type\",\n \"h-2\": \"Description\",\n \"0-0\": \"`customer-reference-number`\",\n \"1-0\": \"`sales-tax-amount`\",\n \"2-0\": \"`freight-amount`\",\n \"3-0\": \"`duty-amount`\",\n \"4-0\": \"`destination-zip-code`\",\n \"5-0\": \"`destination-country-code`\",\n \"6-0\": \"`ship-from-zip-code`\",\n \"7-0\": \"`discount-amount`\",\n \"8-0\": \"`tax-amount`\",\n \"9-0\": \"`tax-rate`\",\n \"11-0\": \"`level-3-data-item`\",\n \"0-1\": \"*string*\",\n \"1-1\": \"*decimal*\",\n \"2-1\": \"*decimal*\",\n \"3-1\": \"*decimal*\",\n \"4-1\": \"*string*\",\n \"5-1\": \"*string*\",\n \"6-1\": \"*string*\",\n \"7-1\": \"*decimal*\",\n \"8-1\": \"*decimal*\",\n \"9-1\": \"*decimal*\",\n \"11-1\": \"*container*\",\n \"0-2\": \"Reference number used by shopper to track order.\",\n \"1-2\": \"Total sales tax amount.\",\n \"2-2\": \"Shipping amount.\",\n \"3-2\": \"Total charges for import/export duties included in transaction.\",\n \"4-2\": \"Destination zip code.\",\n \"5-2\": \"Destination [country code](doc:country-codes).\",\n \"6-2\": \"The zip code of the location from where the items were shipped.\",\n \"7-2\": \"Discount amount applied to transaction.\",\n \"8-2\": \"Total tax/VAT amount for transaction.\",\n \"9-2\": \"Tax/VAT rate applied to transaction.\",\n \"11-2\": \"Container of [level-3-data-item](doc:level-3-data-item) properties.\\n\\n*May appear multiple times in response*\",\n \"10-0\": \"`transaction-processed-with-l3d-supported-acquirer`\",\n \"10-1\": \"*boolean*\",\n \"10-2\": \"Indicates whether transaction was processed with an acquirer that supports Level 2/3 data.\"\n },\n \"cols\": 3,\n \"rows\": 12\n}\n[/block]","updates":[],"order":26,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ff4b747849e1b03c5068435","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Resources","slug":"resources","order":16,"from_sync":false,"reference":false,"_id":"5ff4b747849e1b03c5068415","version":"5ff4b747849e1b03c50684c7","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.36.1 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ff4b747849e1b03c5068409","5ff4b747849e1b03c506840a","5ff4b747849e1b03c506840b","5ff4b747849e1b03c506840c","5ff4b747849e1b03c506840d","5ff4b747849e1b03c506840e","5ff4b747849e1b03c506840f","5ff4b747849e1b03c5068410","5ff4b747849e1b03c5068411","5ff4b747849e1b03c5068412","5ff4b747849e1b03c5068413","5ff4b747849e1b03c5068414","5ff4b747849e1b03c5068415","5ff4b747849e1b03c5068416","5ff4b747849e1b03c5068417","5ff4b747849e1b03c5068418","5ff4b747849e1b03c5068419","5ff4b747849e1b03c506841a","5ff4b747849e1b03c506841b","5ff4b747849e1b03c506841c"],"_id":"5ff4b747849e1b03c50684c7","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5fd26704abd1b6004f12d72c","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"createdAt":"2018-02-23T14:10:25.590Z","githubsync":"","__v":0}
level-3-data
While all level-3-data
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.
customer-reference-number
string
Reference number used by shopper to track order
Max length: 17
sales-tax-amount
decimal
Total sales tax amount
Max length: 12
freight-amount
decimal
Shipping amount
Max length:
- Mastercard: 9
- Visa: 12
duty-amount
decimal
Total charges for import/export duties included in transaction
Max length:
- Mastercard: 9
- Visa: 12
destination-zip-code
string
Destination zip code
Max length: 10
ship-from-zip-code
string
The zip code of the location from where the items were shipped
Max length: 10
discount-amount
decimal
Discount amount applied to transaction
Max length: 12
tax-amount
decimal
Total tax/VAT amount for transaction
Max length: 12
tax-rate
decimal
Tax/VAT rate applied to transaction
Max length: 4
level-3-data-item
container
Container of level-3-data-item properties.
May appear multiple times in request
customer-reference-number
string
Reference number used by shopper to track order.
sales-tax-amount
decimal
Total sales tax amount.
freight-amount
decimal
Shipping amount.
duty-amount
decimal
Total charges for import/export duties included in transaction.
destination-zip-code
string
Destination zip code.
ship-from-zip-code
string
The zip code of the location from where the items were shipped.
discount-amount
decimal
Discount amount applied to transaction.
tax-amount
decimal
Total tax/VAT amount for transaction.
tax-rate
decimal
Tax/VAT rate applied to transaction.
transaction-processed-with-l3d-supported-acquirer
boolean
Indicates whether transaction was processed with an acquirer that supports Level 2/3 data.
level-3-data-item
container
Container of level-3-data-item properties.
May appear multiple times in response