Set up and configure Vantiv Payment Gateway API v8.10 or Vantiv gateway instance
Learn how to set up and configure the Vantiv Payment Gateway API v8.10 or Vantiv gateway instance, including testing and integration details.
The Vantiv Payment Gateway API v8.10 or Vantiv gateway integration versions described in this article are no longer under active development. Vantiv (Now Worldpay) is the latest integration version provided by Zuora. See Overview of Vantiv payment gateway integration for details.
Set up and configure a Vantiv Payment Gateway API v8.10 or Vantiv gateway instance by using the information in this article.
Prerequsites
Contact Zuora Global Support to enable this gateway in your tenant.
Confirm with Vantiv support whether your Merchant ID is enabled for the Vantiv test environment and whether your Merchant ID is linked with Zuora's Vantiv Submitter ID for the test environment. Vantiv gateway does not permit access to its test environment using your production Merchant ID, so you must obtain a test Merchant ID for testing purposes.
When your request is sent to the Vantiv Gateway via Zuora, the request is sent with the Zuora's Submitter ID in all environments. Your Merchant IDs can vary per your gateway settings for the production and testing environments.
If you plan to process both credit card and ACH transactions, we recommend that you configure two separate instances of the Vantiv Gateway within Zuora. The first configuration with verification turned on can process credit cards, and the second configuration with verification turned off can process ACH transactions. This setup avoids issues caused by eCheck verification on ACH transactions.
Testing the configuration
For basic guidance on how to test payment gateway integrations within a sandbox environment, see Test payment gateway integration .
Accessing Your Gateway's Test Environment
If Use Gateway Test Environment is selected in your payment gateway configuration, Zuora will direct payment transactions to the Vantiv testing environment that you chose in the Test Environment Type field in the Credentials section.
You will be accessing a test environment linked to Zuora's Submitter ID.
If Use Gateway Test Environment is not selected, Zuora will direct payment transactions to the Vantiv production environment.
Test Credit Cards and Testing Scenarios
Test credit card numbers and testing scenarios can be found in the Vantiv XML Reference Guide. Please work with your Vantiv implementation analyst to retrieve all necessary information for testing. Contact Vantiv Support for the latest version of the Vantiv XML Reference Guide. This guide provides specific credit card account numbers and data to include in your testing to generate specific gateway responses.
General Testing Information
Integration Testing
Performance and Volume Testing
In general, gateway testing environments are intended to give merchants the opportunity to test their gateway and integrations to their gateway, in order to work out any bugs before going to the production environment. Some gateway test environments are shared amongst multiple merchants, and other gateways provide unique testing environments for each merchant. Additionally, gateway test environments (also referred to as certification or sandbox environments) do not have the same high availability or performance capability as production environments. As such, they are not intended for load testing. Merchants performing high volumes of load testing that puts a stress on a shared test environment may receive a warning from the gateway or have their access to the testing environment suspended.
Related information
-
Overview of Vantiv payment gateway integration
-
Set up and configure a Vantiv (Now Worldpay) gateway instance
-
Set up and configure a Vantiv (Reconciliation Only) gateway instance
-
Troubleshoot gateway errors for Vantiv