{"_id":"5bedd214812951004a2ad989","category":{"_id":"5bedd214812951004a2ad94e","version":"5bedd214812951004a2ad9df","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:20:51.519Z","from_sync":false,"order":11,"slug":"resources","title":"JSON Objects"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"5bedd214812951004a2ad9df","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5bcf36ac4eaaa605217d94b8","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z","categories":["5bedd214812951004a2ad943","5bedd214812951004a2ad944","5bedd214812951004a2ad945","5bedd214812951004a2ad946","5bedd214812951004a2ad947","5bedd214812951004a2ad948","5bedd214812951004a2ad949","5bedd214812951004a2ad94a","5bedd214812951004a2ad94b","5bedd214812951004a2ad94c","5bedd214812951004a2ad94d","5bedd214812951004a2ad94e","5bedd214812951004a2ad94f","5bedd214812951004a2ad950","5bedd214812951004a2ad951"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.28 Release","version_clean":"8976.0.0-JSON","version":"8976-JSON"},"githubsync":"","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-02-22T19:32:03.376Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","examples":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":19,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"While all `level3Data` 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\n###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"h-3\": \"Description\",\n    \"0-0\": \"`customerReferenceNumber`\",\n    \"0-1\": \"*string*\",\n    \"0-2\": \"Optional\",\n    \"0-3\": \"Reference number used by shopper to track order.\",\n    \"1-0\": \"`salesTaxAmount`\",\n    \"1-1\": \"*decimal*\",\n    \"1-2\": \"Optional\",\n    \"2-0\": \"`freightAmount`\",\n    \"3-0\": \"`dutyAmount`\",\n    \"4-0\": \"`destinationZipCode`\",\n    \"5-0\": \"`destinationCountryCode`\",\n    \"6-0\": \"`shipFromZipCode`\",\n    \"7-0\": \"`discountAmount`\",\n    \"8-0\": \"`taxAmount`\",\n    \"9-0\": \"`taxRate`\",\n    \"10-0\": \"`level3DataItems`\",\n    \"2-2\": \"Optional\",\n    \"3-2\": \"Optional\",\n    \"4-2\": \"Optional\",\n    \"5-2\": \"Optional\",\n    \"6-2\": \"Optional\",\n    \"7-2\": \"Optional\",\n    \"8-2\": \"Optional\",\n    \"9-2\": \"Optional\",\n    \"10-2\": \"Optional\",\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\": \"*array*\",\n    \"1-3\": \"Total sales tax amount.\",\n    \"2-3\": \"Shipping amount.\",\n    \"3-3\": \"Total charges for import/export duties included in transaction.\",\n    \"4-3\": \"Destination zip code.\",\n    \"5-3\": \"Destination [country code](doc:country-codes).\",\n    \"6-3\": \"The zip code of the location from where the items were shipped.\",\n    \"7-3\": \"Discount amount applied to transaction.\",\n    \"8-3\": \"Total tax/VAT amount for transaction.\",\n    \"9-3\": \"Tax/VAT rate applied to transaction.\",\n    \"10-3\": \"Array containing one or more [level3DataItems](doc:level3dataitems) objects.\"\n  },\n  \"cols\": 4,\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\": \"`customerReferenceNumber`\",\n    \"1-0\": \"`salesTaxAmount`\",\n    \"2-0\": \"`freightAmount`\",\n    \"3-0\": \"`dutyAmount`\",\n    \"4-0\": \"`destinationZipCode`\",\n    \"5-0\": \"`destinationCountryCode`\",\n    \"6-0\": \"`shipFromZipCode`\",\n    \"7-0\": \"`discountAmount`\",\n    \"8-0\": \"`taxAmount`\",\n    \"9-0\": \"`taxRate`\",\n    \"11-0\": \"`level3DataItems`\",\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\": \"*array*\",\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\": \"Array containing one or more [level3DataItems](doc:level3dataitems) objects.\",\n    \"10-0\": \"`transactionProcessedWithL3dSupportedAcquirer`\",\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]","excerpt":"Contains Level 2/3 data properties for the transaction","slug":"level3data","type":"basic","title":"level3Data"}

Payment API (JSON)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Refunds

Vaulted Shoppers

Subscriptions

Marketplace

Wallets

Errors

JSON Objects

Test Data & Codes

Guides & Tools

Mobile SDK

level3Data

Contains Level 2/3 data properties for the transaction

While all level3Data 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
Required
Description

customerReferenceNumber

string

Optional

Reference number used by shopper to track order.

salesTaxAmount

decimal

Optional

Total sales tax amount.

freightAmount

decimal

Optional

Shipping amount.

dutyAmount

decimal

Optional

Total charges for import/export duties included in transaction.

destinationZipCode

string

Optional

Destination zip code.

destinationCountryCode

string

Optional

Destination country code.

shipFromZipCode

string

Optional

The zip code of the location from where the items were shipped.

discountAmount

decimal

Optional

Discount amount applied to transaction.

taxAmount

decimal

Optional

Total tax/VAT amount for transaction.

taxRate

decimal

Optional

Tax/VAT rate applied to transaction.

level3DataItems

array

Optional

Array containing one or more level3DataItems objects.

Response

Property Name
Type
Description

customerReferenceNumber

string

Reference number used by shopper to track order.

salesTaxAmount

decimal

Total sales tax amount.

freightAmount

decimal

Shipping amount.

dutyAmount

decimal

Total charges for import/export duties included in transaction.

destinationZipCode

string

Destination zip code.

destinationCountryCode

string

Destination country code.

shipFromZipCode

string

The zip code of the location from where the items were shipped.

discountAmount

decimal

Discount amount applied to transaction.

taxAmount

decimal

Total tax/VAT amount for transaction.

taxRate

decimal

Tax/VAT rate applied to transaction.

transactionProcessedWithL3dSupportedAcquirer

boolean

Indicates whether transaction was processed with an acquirer that supports Level 2/3 data.

level3DataItems

array

Array containing one or more level3DataItems objects.