Overview of Vantiv payment gateway integration
Learn about integrating with Vantiv (Now Worldpay) for payment processing, reconciliation, and support for Level 2 and Level 3 card data.
Zuora supports the following versions of Vantiv payment gateway integration:
-
Vantiv (Now Worldpay) - To process payments, use this integration version and your Merchant ID. This version is the latest integration version for payment processing.
-
Vantiv (Reconciliation Only) - To process gateway reconciliation, use this integration version and your Organization ID.
-
Vantiv Payment Gateway, API v8.10
-
Vantiv: previously called Litle gateway integration
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:
-
Level 2 and Level 3 support for Vantiv (Now Worldpay)
-
Set up and configure a Vantiv (Now Worldpay) gateway instance
-
Level 2 and Level 3 Card Data
Support for stored credential profiles
Vantiv (Now Worldpay) and Vantiv Payment Gateway, API v8.10 include support for the Stored Credential Transactions framework, but they do not support the sharing NTI feature. For details, see Support for stored credential transactions overview .
On Vantiv (Now Worldpay), if you want to submit the
processingType=initialRecurring
indicator field to the gateway when processing payment without an NTI on the payment method, submit a request at Zuora Global Support
. After the payment is processed successfully, the NTI returned from the gateway is stored in Zuora and used in subsequent recurring transactions.
Support for Gateway Reconciliation
To process gateway reconciliation, it is strongly recommended to use the Vantiv (Reconciliation Only) gateway integration and your Organization ID . The Gateway Reconciliation support on Vantiv (Now Worldpay) is limited.
The following Gateway Reconciliation events are supported:
-
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 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:
-
Set up and configure a Vantiv (Reconciliation Only) gateway instance
-
Gateway Reconciliation
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.
Related information
-
Set up and configure a Vantiv (Now Worldpay) gateway instance
-
Set up and configure Vantiv Payment Gateway API v8.10 or Vantiv gateway instance
-
Set up and configure a Vantiv (Reconciliation Only) gateway instance
-
Troubleshoot gateway errors for Vantiv