Overview of Vantiv payment gateway integration (2024)

  1. Last updated
  2. Save as PDF

Zuora supports the following versions of Vantivpayment gateway integration:

  • Vantiv (Now Worldpay) - To process payments, use this integration version and your Merchant ID. This version isthe 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)
(recommended version)
Vantiv Payment Gateway, API v8.10 Vantiv Vantiv (Reconciliation Only)
Development status Active Inactive Inactive Active
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 3card 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 Vantivintegration 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 methodsin Zuora, seeDefine and set up payment methods.

Supprtfor Level 2 and Level 3 card data processing

The Vantiv (Now Worldpay)gateway integration supportsprocessing Level 2 and Level 3 credit card data.For more information, see the following articles:

  • Set up and configure a Vantiv (Now Worldpay) gateway instance
  • Level 2 and Level 3 Card Data

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 includesupport for theStored Credential Transactionsframework, but they do not support thesharing NTIfeature. For details,seeSupport 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 onVantiv (Now Worldpay) is limited.

The following Gateway Reconciliation events are supported:

  • Settlement
  • Rejection
  • Chargeback

The following three reports must beset up by your Worldpayrepresentative or enabled for yourmerchantaccount on https://reports.vantivcnp.com/ui/login.Once the reports have been set up, you have tocontact Worldpayto set up theSFTPusername and password for your file repository and ensure the daily generated reports are deposited into the SFTPserver. Then youshould add your SFTPusername 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} (youmust 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 toWorldpay eComm Scheduled Secure Reports Reference Guideto 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 opena generated report on yourmerchant console, Vantivwill automatically archivethe report.Thus the automated file pull requestfrom 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 upthe VantivPayment Method Updaterservice in Zuora, seeConfigure 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
Overview of Vantiv payment gateway integration (2024)

References

Top Articles
Latest Posts
Article information

Author: Duncan Muller

Last Updated:

Views: 6812

Rating: 4.9 / 5 (79 voted)

Reviews: 94% of readers found this page helpful

Author information

Name: Duncan Muller

Birthday: 1997-01-13

Address: Apt. 505 914 Phillip Crossroad, O'Konborough, NV 62411

Phone: +8555305800947

Job: Construction Agent

Hobby: Shopping, Table tennis, Snowboarding, Rafting, Motor sports, Homebrewing, Taxidermy

Introduction: My name is Duncan Muller, I am a enchanting, good, gentle, modern, tasty, nice, elegant person who loves writing and wants to share my knowledge and understanding with you.