Welcome to Zuora Product Documentation

Explore our rich library of product information

Configuration fields

Learn about the common and unique configuration fields required for setting up a payment gateway in Zuora.

There are some common fields you must complete for every gateway configuration. We recommend reviewing our Setup Payment Gateway documentation for information on these common fields:

  • Name

  • Use Gateway Test Environment

  • Test Environment Type

  • Merchant ID

  • Cards Accepted

  • Default Authorization Amount

  • Verify new payment method (optional)

  • Verify updated payment method (optional)

In addition to the common fields, every gateway has unique requirements and information (such as credentials) that you must provide to configure the gateway in Zuora.

Click and select the Merchant ID number for the gateway configuration. The Merchant ID number should be the same one you provided to Zuora Global Support to enable in your tenant, and the ID(s) will appear as a picklist in the gateway configuration page. If you have more than one Merchant ID number, you can set up multiple gateway configurations for the Merchant IDs and provide all the Merchant ID numbers to Zuora Global Support for enablement.

If the Use Gateway Test Environment option is selected, click and select the test environment type in the Test Environment Type field. The Pre Live and Post Live environments are available.

Pre Live environment

The Pre Live test environment is the platform used for all merchant testing. You should use this environment if you are a newly on-boarding Vantiv merchant or if you are an existing Vantiv merchant seeking to incorporate additional features or functionalities.

Post Live environment

The Post Live testing environment is intended for merchants that are already fully certified and submitting transactions to the Vantiv Production platform, but wish to perform regression or other tests to confirm the operational readiness of modifications to their own systems.

If enabled, Zuora will decline Credit Card transactions for certain AVS response codes returned by the gateway, even if the gateway has approved the transaction. Default is disabled.

If enabled, Zuora will decline Credit Card transactions for certain CVV response codes returned by the gateway, even if the gateway has approved the transaction. Default is disabled.

AVS Response Codes

Description

10

5-Digit zip matches, address does not match

11

9-Digit zip matches, address does not match

12

Zip does not match, address matches

13

Postal code does not match, address matches

20

Neither zip nor address match

33

General error

40

Address failed Vantiv edit checks

CVV Response Codes

Description

N

No match

If you accept credit card payment methods, you may consider enabling the Support Recurring option. If Support Recurring is selected, Zuora will mark such payments as recurring when submitting the sale payment transactions to Vantiv. For recurring payments, this option may result in reduced fees and greater acceptance with your merchant bank. Check with Vantiv to verify that this is available and appropriate for your account.

The Commerce Indicator identifies the source channel of the transaction request (i.e., the environment that the cardholder used to provide the payment card details to the merchant) and the type of transaction being processed. Select one of the following values from the list:

  • E-Commerce (default)

  • Installment

  • Mail Order

  • Recurring

  • Retail

  • Telephone

  • Recurring Telephone (eCheck only)

Perform the following steps to ensure that first and recurring transactions are set up properly:

  1. Verify the Vantiv gateway instance is set up in the following way:
    • Check Support Recurring

    • Commerce Indicator set to E-Commerce

  2. Check the transaction logs to see if the indicator value is set as expected.