Skip to main content

Overview of Vantiv payment gateway integration

Zuora

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
  • Credit Card Reference
  • ACH
  • Apple Pay

Credit Card/Prepaid Card/Gift Card

  • Credit Card/Prepaid Card/Gift Card
  • Credit Card Reference
  • ACH
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:
    • Visa
    • MasterCard
    • American Express
    • Discover
  • Credit Card Reference
  • ACH
  • Apple Pay

Credit Card/Prepaid Card/Gift Card:

  • Visa
  • MasterCard
  • American Express
  • Discover
  • Credit Card/Prepaid Card/Gift Card:
    • Visa
    • MasterCard
    • American Express
    • Discover
  • Credit Card Reference
  • ACH

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:

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.