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. |