Welcome to Zuora Product Documentation

Explore our rich library of product information

Field mapping and constraints

This document outlines the mapping of Adyen Level2/Level3 fields to Zuora fields, including constraints such as maximum character lengths and specific conditions for field values based on credit card types and currency.

Adyen Level2/Level3 field

Zuora field and constrants

enhancedSchemeData.customerReference

Invoice number if it is present. The maximum length is 25 characters.

enhancedSchemeData.itemDetailLine[itemNr].productCode

Must be configured in Zuora product catalog as ProductRatePlanCharge level custom fields. The maximum length is 12 characters.

enhancedSchemeData.itemDetailLine[itemNr].commodityCode

Must be configured in Zuora product catalog as ProductRatePlanCharge level custom fields. The maximum length is 12 characters.

enhancedSchemeData.shipFromPostalCode

Must be configured as an Account level custom field in Zuora. This value is passed to the gateway when the credit card type is not American Express. The maximum length is 10.

enhancedSchemeData.dutyAmount

If the credit card type is not American Express, this field is set to 0.

enhancedSchemeData.itemDetailLine[itemNr].description

This field will be populated only when the InvoiceItem description field is not empty. The value will be InvoiceItem charge name. The maximum length is 26. If you want to remove the dependency on the InvoiceItem description field, Submit a request at Zuora Global Support

enhancedSchemeData.itemDetailLine[itemNr].quantity

The quantity field on the InvoiceItem object in Zuora if it is present. The maximum length is 12.

enhancedSchemeData.itemDetailLine[itemNr].unitOfMeasure

The unitofmeasure field on the InvoiceItem object in Zuora if it is present. The maximum length is 3.

enhancedSchemeData.itemDetailLine[itemNr].totalAmount

Zuoraa combines the values from the amount_without_tax and tax_amount fields on the InvoiceItem object and consider it as totalAmount. If the currency is any of "BYR, CVE, DJF, GHC, GNF, IDR, JPY, KMF, KRW, PYG, RWF, UGX, VND, VUV, XAF, XOF, XPF"(zero decimal currency), the value of totalAmount is rounded to 2 decimal places. Otherwise, the value of totalAmount is rounded to 2 decimal places and multiplied by 100.

The maximum length is 12.

enhancedSchemeData.itemDetailLine[itemNr].unitPrice

The unitprice field on the InvoiceItem object in Zuora and it is rounded to 2 decimal places.

enhancedSchemeData.itemDetailLine[itemNr].discountAmount

The discount field on the InvoiceItem object in Zuora and it is rounded to 2 decimal places. This field is passed to the gateway when the credit card type is not American Express. If the currency is any of "BYR, CVE, DJF, GHC, GNF, IDR, JPY, KMF, KRW, PYG, RWF, UGX, VND, VUV, XAF, XOF, XPF"(zero decimal currency), discount is the same value. Otherwise, totalTaxAmount is multiplied by 100. The maximum length is 12.

enhancedSchemeData.totalTaxAmount

The tax amount field on the InvoiceItem object in Zuora. If the currency is any of "BYR, CVE, DJF, GHC, GNF, IDR, JPY, KMF, KRW, PYG, RWF, UGX, VND, VUV, XAF, XOF, XPF"(zero decimal currency), totalTaxAmount is the same value. Otherwise, totalTaxAmount is multiplied by 100.

The maximum length is 12.

enhancedSchemeData.destinationCountryCode

If the value of the SoldToContactCountry field (3-letter ISO code) is present and the credit card type is not American Express, Zuora sets this field to the value same as SoldToContactCountry. The maximum length is 3 characters.

enhancedSchemeData.destinationPostalCode

If the value of the SoldToContactZip field is present, Zuora sets this field to the value same as SoldToContactZip. The maximum length is 10 characters.

enhancedSchemeData.destinationStateProvinceCode

If the value of the SoldToContactState field is present and the credit card type is American Express, Zuora sets this field to the 2-letter state code if the SoldToContactState length is greater than 2 and SoldToContactCountry value is present. Otherwise, keep the value the same as SoldToContactState.

enhancedSchemeData.orderDate

If the credit card type is American Express, Zuora sets the date and time in PST timezone.