Configuration fields for Worldline Global Collect Legacy payment gateway integration
This reference outlines the essential fields required for configuring payment gateways in Zuora, including AVS and CVV filtering options, credentials, and specific configurations for Worldline Global Collect Legacy.
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
-
Soft Descriptor (Direct Debit Text)
-
Cards Accepted
-
Default Authorization Amount Note that 0 is not permitted. If 0 is entered in this field, Zuora will automatically change it to 1 in order to avoid transaction failure.
-
Verify new payment method (optional)
-
Verify updated payment method (optional)
-
Support Recurring
-
Collection offset (days)
-
Enable AVS Filtering
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.
-
Enable CVV Filtering
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 and CVV Response Codes
The following table lists the AVS and CVV response codes:
|
AVS Response Codes |
Description |
|---|---|
|
N |
No match |
|
CVV Reponse Code |
Description |
|
N |
CVV checked and no match |
Credentials
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. For Worldline Global Collect Legacy, you must select a Merchant ID and provide a Soft Descriptor.
Merchant ID
Your merchant ID is a unique ID (a numeric value of up to 10 digits) that is provided to you by Worldline Global Collect Legacy. The merchant ID number should be the same one you provided to Zuora Global Support to enable in your tenant, and the IDs will appear as a list in the gateway configuration page. If you have more than one Merchant ID number, you configure multiple gateways for each Merchant ID number.
Soft Descriptor (Direct Debit Text)
Soft Descriptor is a dynamic descriptor (text) that helps the customer identify the merchant's business on their statement. This is important, because charge backs can occur if a customer does not recognize the merchant debiting their account and believes that it is an unauthorized charge.
Support Recurring
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 Worldline Global Collect Legacy. For recurring payments, this option may result in reduced fees for the subsequent payments. and greater acceptance with your merchant bank.
Collection Offset (Days)
Collection Offset informs Worldline Global Collect Legacy to delay collection of a UK Direct Debit payment by the specified number of days. The default is five days.
For example, if you submit a request to process the payment on 8/5/14, with an offset date of five days, then they would submit the payment to be collected on 8/10/15.
Zuora recommends setting the field to five days. This accounts for the delay of setting up a mandate and the initial payment that is immediately processed by Zuora. If the acquisition flow considers this delay already, then the offset should be reduced to accelerate collections of recurring payments.
Implement Direct Debit
Although direct debit is treated as any other electronic payment method in Zuora, there are some additional steps required to implement this payment method. See Implementing Direct Debit with Worldline Global Collect Legacy for information about using direct debit with Zuora.