Skip to main content

Field mappings between Zuora and CyberSource

Zuora

Field mappings between Zuora and CyberSource

  1. Last updated
  2. Save as PDF

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

Deprecation Notice

On 28 February 2024 PDT, we will deprecate the following payment gateway integrations, following changes to Cybersource’s authentication standards:

  • CyberSource Enterprise Gateway, API v1.97
  • CyberSource Enterprise Gateway, API v1.28

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