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.
Deprecation NoticeOn 28 February 2024 PDT, we will deprecate the following payment gateway integrations, following changes to Cybersource’s authentication standards:
If you are on one of the preceding integrations, to prevent service disruption, please migrate to the CyberSource, Payment API v2.0 payment gateway integration by following this migration guide before 28 February 2024. We also recommend you to avoid creating new instances of integrations that will be deprecated. For any questions, please contact Zuora Global Support. |
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, If the account holder name contains the ampersand (&) character, |
billTo_lastName | PaymentMethod.AchAccountName |
If the account name does not contain the ampersand (&) character, If the account holder name contains the ampersand (&) character, |
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 |