level-3-data

Contains Level 2/3 data properties for the transaction

📘

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.

Request

Property NameTypeDescription
customer-reference-numberstringReference number used by shopper to track order
Max length: 17
destination-country-codestringDestination country code
Max length: 3
destination-zip-codestringDestination zip code
Max length: 10
discount-amountdecimalDiscount amount applied to transaction
Max length: 12
duty-amountdecimalTotal charges for import/export duties included in transaction
Max length:
Mastercard: 9
Visa: 12
freight-amountdecimalShipping amount
Max length:
Mastercard: 9
Visa: 12
level-3-data-itemcontainerContainer of level-3-data-item properties.

May appear multiple times in request
sales-tax-amountdecimalTotal sales tax amount
Max length: 12
ship-from-zip-codestringThe zip code of the location from where the items were shipped
Max length: 10
tax-amountdecimalTotal tax/VAT amount for transaction
Max length: 12
tax-ratedecimalTax/VAT rate applied to transaction
Max length: 4

Response

Property NameTypeDescription
customer-reference-numberstringReference number used by shopper to track order.
destination-country-codestringDestination country code.
destination-zip-codestringDestination zip code.
discount-amountdecimalDiscount amount applied to transaction.
duty-amountdecimalTotal charges for import/export duties included in transaction.
freight-amountdecimalShipping amount.
level-3-data-itemcontainerContainer of level-3-data-item properties.

May appear multiple times in response
sales-tax-amountdecimalTotal sales tax amount.
ship-from-zip-codestringThe zip code of the location from where the items were shipped.
tax-amountdecimalTotal tax/VAT amount for transaction.
tax-ratedecimalTax/VAT rate applied to transaction.
transaction-processed-with-l3d-supported-acquirerbooleanIndicates whether transaction was processed with an acquirer that supports Level 2/3 data.