Overview of Vantiv payment gateway integration
Zuora supports the following versions of Vantiv payment gateway integration:
- Vantiv (Now Worldpay) - the latest integration version
- Vantiv Payment Gateway, API v8.10
- Vantiv
Vantiv (Now Worldpay) was previously called Litle & Co. Vantiv (Now Worldpay) is the replacement for Litle gateway integration.
Supported features
The following table provides a quick reference for the supported features. For details about each feature, see the later sections in this article.
| Feature | Vantiv (Now Worldpay) | Vantiv Payment Gateway, API v8.10 | Vantiv |
|---|---|---|---|
| Supported payment methods |
|
Credit Card/Prepaid Card/Gift Card |
|
| Support 3D Secure 2.0 | No | No | No |
| Support Delayed Capture | No | No | No |
| Support Level 2 and Level 3 card data | Yes | No | No |
| Support stored credential transactions | Yes | Yes | No |
| Support Gateway Options fields | Yes | No | No |
| Gateway provider’s API version | cnpOnlineRequestVersion 12.2 | N/A | N/A |
| Gateway production endpoint used for Zuora gateway integration service | https://payments.vantivcnp.com/vap/communicator/online |
N/A | |
| Support Gateway Reconciliation | Yes | No | No |
| Gateway production endpoint used for Gateway Reconciliation service | sftp://reports.vantivcnp.com |
N/A | N/A |
| Support Payment Method Updater | Yes (Visa, MasterCard) | ||
| Gateway production endpoint used for PMU service | sftp://batch.vantivcnp.com |
https://payments.litle.com:15000 |
|
Supported payment methods
The following table lists the supported payment methods for each Vantiv integration version:
| Vantiv (Now Worldpay) | Vantiv Payment Gateway, API v8.10 | Vantiv | |
|---|---|---|---|
| Supported Payment Methods |
|
Credit Card/Prepaid Card/Gift Card:
|
|
For more information about setting up payment methods in Zuora, see Define and set up payment methods.
Supprt for Level 2 and Level 3 card data processing
The Vantiv (Now Worldpay) gateway integration supports processing Level 2 and Level 3 credit card data. For more information, see the following articles:
To submit Level 2 data to Vantiv (Now Worldpay) gateways, in addition to the required fields and preconditions described in Level 2 and Level 3 Card Data, make sure the VAT ID field of your Zuora customer account must be specified with your Tax ID.
Support for stored credential profiles
Vantiv (Now Worldpay) and Vantiv Payment Gateway, API v8.10 include support for the Stored Credential Transactions framework. For details about the supported payment methods, see Support for stored credential transactions overview.
Support for Gateway Reconciliation
The Gateway Reconciliation for Vantiv (Now Worldpay) works only in the production environment.
Vantiv (Now Worldpay) supports the following Gateway Reconciliation events:
- Settlement
- Rejection
- Chargeback
The following three reports must be set up by your Worldpay representative or enabled for your merchant account on https://reports.vantivcnp.com/ui/login. Once the reports have been set up, you have to contact Worldpay to set up the SFTP username and password for your file repository and ensure the daily generated reports are deposited into the SFTP server. Then you should add your SFTP username and password to your gateway settings and ensure that the Enable Gateway Reconciliation check box is selected.
- Financial_Detail_ChargebackFinancialBySettlementDate${rptCategoryId}_${organizationId}_$ {targetDay}
- Financial_Detail_NssByTxnBySettlementDate${rptCategoryId}${currencyAlpha}${negativeRefund}_${organizationId}_${targetDay} (you must specify the negative refund field as
conveyed negative refund.) - Declined_Transactional_Report_${organizationId}_${targetDay}
You must use the settlement date instead of the activity date for report generation. Refer to Worldpay eComm Scheduled Secure Reports Reference Guide to learn more about these reports.
Example valid report names are:
- Financial_Detail_NssByTxnBySettlementDate0ConveyedNegativeRefund_65600_20200813.CSV
- Declined_Transaction_Report_65600_20200813.CSV
- Financial_Detail_ChargebackFinancialBySettlementDate0_65600_20200813.CSV
Note that if you manually open a generated report on your merchant console, Vantiv (Now Worldpay) will automatically archive the report. Thus the automated file pull request from Zuora will fail.
For more information about enabling and configuring the Gateway Reconciliation service, see the following articles:
Support for Payment Method Updater
To set up the Vantiv Payment Method Updater service in Zuora, see Configure Vantiv Payment Method Updater for more information.