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

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