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

Description

customerReferenceNumber

string

Reference number used by shopper to track order
Max length: 17

salesTaxAmount

decimal

Total sales tax amount
Max length: 12

freightAmount

decimal

Shipping amount
Max length:

  • Mastercard: 9
  • Visa: 12

dutyAmount

decimal

Total charges for import/export duties included in transaction
Max length:

  • Mastercard: 9
  • Visa: 12

destinationZipCode

string

Destination zip code
Max length: 10

destinationCountryCode

string

Destination country code
Max length: 3

shipFromZipCode

string

The zip code of the location from where the items were shipped
Max length: 10

discountAmount

decimal

Discount amount applied to transaction
Max length: 12

taxAmount

decimal

Total tax/VAT amount for transaction
Max length: 12

taxRate

decimal

Tax/VAT rate applied to transaction
Max length: 4

level3DataItems

array

Container of level3DataItems properties.

May appear multiple times in request

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.