home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Worldline Global Collect Legacy Payment Gateway

Set up and configure a Worldline Global Collect Legacy gateway instance

Follow these steps to set up and configure a Worldline Global Collect Legacy gateway instance, including selecting the gateway type and entering necessary information.

IP address whitelist configuration

This gateway 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 .

Worldline Global Collect Legacy Merchant Account Configuration

Work with your Worldline Global Collect Legacy implementation manager to ensure your Worldline Global Collect Legacy merchant account is configured to support a two-step payment process for Sale transactions. To do this, Worldline Global Collect Legacy will configure the delayed settlement per card type setting in your account by setting the indicator to the value to 7. This ensures the payment transactions are pending until triggered via the set_payment for settlement.

Clarification on API calls for Sale transactions:

For Sale transactions, the integration uses a two-step process with the following Worldline Global Collect Legacy API calls: Insert Order With Payment() + SetPayment() .

  • Insert Order with Payment() - This call inserts an order and a payment in a single API call combining the Insert Order() and a Do Payment() action in a single call.

  • SetPayment - This call is used to settle authorized credit card payments or to register mandates for direct debit.

Error if Account is Not Configured for Two-Step Sale Process

It is very important for your account to be configured properly to accept the two-step Sale call. If it is not configured correctly, your transactions may error with Worldline Global Collect Legacy code "410110."

Note:

By default, the integration and your Worldline Global Collect Legacy account support a one-step process for Refund transactions, so no action is required from you to ensure that this configuration is correct on your merchant account. With the one-step process, Zuora will make a DoRefund call, and Worldline Global Collect Legacy will process the refund automatically.

Set Up a Secure File Transfer (SFT) Account with Worldline Global Collect Legacy

This SFT account allows you to upload and/or download data from Worldline Global Collect Legacy.

Enable the Worldline Global Collect Legacy Payment Gateway Integration for Your Tenant

See Enable payment gateway integrations for your tenant for instructions.

Take the following steps to set up and configure a Worldline Global Collect Legacy gateway instance:

  1. Click your username at the top right and navigate to Settings > Payments > Setup Payment Gateway .
  2. On the Configure Gateway Instance tab, select GlobalCollect (WebCollect Merchant Link) from the Gateway Type drop-down list.
  3. Click Create Gateway .
  4. Complete the information for the gateway instance. See below for more information on the fields. Note that all the configuration fields do not support the vertical line character "|". For password fields, if your gateway assigns a password containing this character, Zuora will display a validation error. To resolve this issue, contact your gateway provider to request a new password without the unsupported character.
  5. Click save gateway information after entering the necessary information.

Last updated: November 30, 2025