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: