Skip to main content

Configure Worldpay Payment Method Updater

Zuora

Configure Worldpay Payment Method Updater

To adapt Worldpay's migration from Worldpay Updater to Vantiv Updater, Zuora has stopped supporting creating new Worldpay Payment Method Updater instances, and will discontinue the existing Payment Method Updater service on 2019-11-01 at 00:00 GMT.


If you want to use the Vantiv Updater service but only have a Worldpay merchant account, contact Worldpay Support to get a new Vantiv merchant account, and follow Configure Vantiv Payment Method Updater to configure your Vantiv Payment Method Updater instance.

Overview

This article describes how to configure Worldpay Payment Method Updater in Zuora for Visa and MasterCard.

This updater requires adding Zuora EU or US Cloud Data Center IP addresses to the whitelist for each of your gateway merchant accounts, depending on which data center that your tenant is located at. Therefore, before start using this gateway on Zuora EU or US Cloud Data Center, you must contact with the gateway to add Zuora EU or US Clould Data Center IP addresses to the gateway's whitelist for both the Sandbox and Production environments so that both environments can work properly.
For more information about the Zuora EU or US Cloud Data Center IP addresses, see Outbound IP Addresses Whitelisting.

Set Up Worldpay Payment Method Updater

Zuora is integrated with the Worldpay High Capacity Gateway for payment method updater service. In order to use this Worldpay updater, you need to enroll in the Worldpay Account Updater program. 

Zuora integrates with a different Worldpay gateway service for payment service. You need separate Worldpay accounts for payment services and payment method updater: a Worldpay account for payment services and a Worldpay High Capacity Gateway account for payment method updater.

To set up the Worldpay High Capacity Gateway Updater in Zuora:

  1. Navigate to Settings > Payments > Setup Payment Method Updater.
  2. Click and select Worldpay in the Updater Type field.
  3. Click add payment method updater.
  4. Select the Updater services. Visa and Master Cards are supported.
  5. Enter your Credentials.
    • Name: Create a name for your updater configuration, for example, Worldpay HCG Updater.
    • Merchant ID: This is the merchant ID provided to you by Worldpay for your High Capacity Gateway Updater account. If you have more than one merchant account, please clarify with Worldpay which merchant account to use for the High Capacity Gateway Updater service.
    • User Name: This is the user name for your Worldpay High Capacity Gateway account and is required. 
    • Password: This is the password that corresponds to the user name that you specified above.
    • Passphrase: Enter the AES-256 passphrase provided by the High Capacity Gateway service. It is used to decrypt response file.
    • SFTP User Name: The user name used for reconciliation.
    • SFTP Password: Password for reconciliation.
  6. Specify a value for the Start Payment Method Updater service days prior to the Bill Cycle Day field. Zuora recommends using the default value of 6 days prior to the Bill Cycle Day because the Worldpay High Capacity Gateway Updater service will take approximately 5 - 6 days to process the credit card account information for updates.
  7. If you select the Only update payment methods for customer accounts associated to this gateway/processor, only the credit cards for customer accounts with Worldpay set as the payment gateway (under Billing and Payment Info) are included in the updates. Disable this field to send all credit card information to Worldpay.
  8. Click save account information.

The bypass credential validation checkbox can be used to for testing purposes. Clicking this checkbox allows you to test Worldpay PMU workflow without entering a passphrase or by entering an incorrect passphrase.