Welcome to Zuora Product Documentation

Explore our rich library of product information

ACH Fields

This topic lists and describes the ACH fields available for Payment Pages 2.0, including field types, lengths, allowed values, and usage notes.

Field Name (case sensitive)Default Field LabelTypeMaximum LengthAllowed ValuesNotes
achBankABACodeABA/Routing NumberString9Zuora recommends making this field required.
achBankAccountNumberBank Account NumberString40Zuora recommends making this field required.
achBankAccountTypeAccount TypeString50
  • Checking
  • Saving
  • BusinessChecking
In the Payment Pages 2.0 configuration UI, the pick list option appears as "Business Checking", but when you specify this value in the client code, you need to use "BusinessChecking" without a space.
Zuora recommends making this field required.
achBankNameBank NameString150Zuora recommends making this field required.
achBankAccountNameAccount Holder NameString150 Zuora recommends making this field required. For hosted Payment Pages on the BlueSnap integration, see Overview of BlueSnap gateway integration for more information about how Zuora splits the string in this field into two parts and passes them to BlueSnap's firstName and lastName fields.
achCityAch CityString40
achStateAch StateString50
achCountryAch CountryString64
phoneContact Phone NumberString32
emailContact EmailString255
achPostalCodeAch Postal CodeString20 This field is added in the R220 release. To add this field to the hosted page, re-create the page.
achAddress1ACH Address 1String255
achAddress2ACH Address 2String255
ipAddressN/AString128 The IP address of the user when the payment method was created or updated. Some gateways use this field for fraud prevention. Both IPv4 and IPv6 are supported. This field is hidden and does not appear on the form.
mandateReceivedStatusMandate ReceivedBoolean1
  • Yes
  • No
existingMandateStatusExisting MandateBoolean1
  • Yes
  • No
mandateIdMandate IDString18
mandateCreationDateDayCreation DateInteger2
mandateCreationDateMonthCreation DateInteger2
mandateCreationDateYearCreation DateInteger4
mandateUpdateDateDayUpdate DateInteger2
mandateUpdateDateMonthUpdate DateInteger2
mandateUpdateDateYearUpdate DateInteger4