Skip to main content

Field mappings between Zuora and CyberSource

Zuora

Field mappings between Zuora and CyberSource

This article describes the object and field mappings between Zuora and CyberSource for credit card and ACH payment methods. 

Credit Card field mappings

API field passed to CyberSource Source of this information in Zuora (object.field)
card_accountNumber PaymentMethod.CreditCardNumber
card_cvNumber PaymentMethod.CreditCardSecurityCode
card_expirationMonth PaymentMethod.CreditCardExpirationMonth
card_expirationYear PaymentMethod.CreditCardExpirationYear
purchaseTotals_currency Account.Currency
item_0_unitPrice Payment.Amount
purchaseTotals_grandTotalAmount Payment.Amount
billTo_email PaymentMethod.Email field
billTo_phoneNumber PaymentMethod.Phone
billTo_ipAddress PaymentMethod.IPAddress
billTo_firstName PaymentMethod.CreditCardHolderName
billTo_lastName PaymentMethod.CreditCardHolderName
billTo_street1 PaymentMethod.CreditCardAddress1
billTo_street2 PaymentMethod.CreditCardAddress2
billTo_city PaymentMethod.CreditCardCity
billTo_customerID Account.AccountNumber
billTo_company Account.Name
billTo_state PaymentMethod.CreditCardState
billTo_postalCode PaymentMethod.CreditCardPostalCode
billTo_country PaymentMethod.CreditCardCountry

ACH field mappings

API field passed to CyberSource Source of this information
in Zuora (object.field)
Description
check_bankTransitNumber PaymentMethod.AchAbaCode  
check_accountNumber PaymentMethod.AchAccountNumber  
purchaseTotals_currency Account.Currency  
item_0_unitPrice Payment.Amount  
purchaseTotals_grandTotalAmount Payment.Amount  
billTo_email PaymentMethod.Email field  
billTo_phoneNumber BillToContact.WorkPhone  
billTo_firstName PaymentMethod.AchAccountName

If the account name does not contain the ampersand (&) character, billTo_firstName is set to the string before the first space from the left.

If the account holder name contains the ampersand (&) character, billTo_firstName is set to NA.

billTo_lastName PaymentMethod.AchAccountName

If the account name does not contain the ampersand (&) character, billTo_lastName is set to the string after the first space from the left.

If the account holder name contains the ampersand (&) character, billTo_lastName is set to the whole string specified for the account holder name.

billTo_street1 BillToContact.Address1  
billTo_street2 BillToContact.Address2  
billTo_city BillToContact.City  
billTo_customerID Account.AccountNumber  
billTo_company Account.Name  
billTo_state BillToContact.State  
billTo_postalCode BillToContact.PostalCode  
billTo_country BillToContact.Country