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) - 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

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 Vantiv (Reconciliation Only)
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 No
Support Delayed Capture No No No No
Support Level 2 and Level 3 card data Yes No No No
Support stored credential transactions Yes Yes No No
Support Gateway Options fields Yes No No No
Gateway provider’s API version cnpOnlineRequestVersion 12.2 N/A N/A N/A
Gateway production endpoint used for Zuora gateway integration service https://payments.vantivcnp.com/vap/communicator/online N/A N/A
Support Gateway Reconciliation Yes, but strongly recommend using Vantiv (Reconciliation Only) for processing gateway reconciliation No No Yes
Gateway production endpoint used for Gateway Reconciliation service sftp://reports.vantivcnp.com N/A N/A sftp://reports.vantivcnp.com
Support Payment Method Updater Yes (Visa, MasterCard) No
Gateway production endpoint used for PMU service sftp://batch.vantivcnp.com https://payments.litle.com:15000 N/A
Support non-referenced refunds

Yes

Supported for Credit Card, Credit Card Reference Transaction, and ACH payment methods

Yes    

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:

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, but they do not support the sharing NTI feature. For details, see Support for stored credential transactions overview.

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:

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.