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

Global Payments Payment Gateway Integration

Set up and configure a Global Payments payment gateway instance

Learn how to set up and configure a Global Payments payment gateway instance, including prerequisites, configuration fields, and testing procedures.

Note:

This payment gateway integration can be requested through the Specialized Payment Connections service at an additional cost.

Set up and configure a Global Payments gateway instance by using the information in this article.

Prerequisites

Make sure you have requested support for Global Payments payment gateway integrations through the Specialized Payment Connections service.

Configuration fields

Basic Information

  • Name : Specify a name for the gateway instance.

  • Use Gateway Test Environment : Select this checkbox, if you want Zuora to use the payment gateway's test service URL when setting up the payment gateway integration.

Credentials

When a merchant account is set up with the gateway, the credential information is assigned by the gateway. The information is used to identify the account through which the transaction will be processed. The following credentials provided by Global Payments must be configured in Zuora:

  • MerchantName

  • MerchantSiteId

  • MerchantKey

Rules

  • Cards Accepted : Select the cards you want to accept. Make sure your gateway's merchant account is also configured to support the same cards you have configured in Zuora. If you submit a transaction for a card type that is not enabled in your merchant account, it will result in an error stating the CardType is not supported or that you are not signed up for that tender type.

  • Default Authorization Amount : Specify the minimum default amount used to authorize or validate a payment. The default value of this field is 1.

  • Verify new payment method : Select this checkbox to verify the payment methods when creating them. By default, this checkbox is selected. For tokenized payment methods, you must validate them in Zuora so that payments made with these payment methods are successful.

  • Verify updated payment method : Select this checkbox to verify the payment methods when updating them. By default, this checkbox is selected. For tokenized payment methods, you must validate them in Zuora so that payments made with these payment methods are successful.

  • The following fields are related to Level 2 and Level 3 card data processing. See Level 2 and Level 3 card data support for Global Payments for details.

    • Enable L2

    • Enable L3

    • CommodityCode Custom Field API Name

    • ProductCode Custom Field API Name

Test the configuration

For basic guidance on how to test payment gateway integrations within a sandbox environment, see Test payment gateway integration .

You can use the test information and testing scenarios provided by Global Payments to test your integration. For more information, see Global Payments documentation .

  • Overview of Global Payments payment gateway integration

  • Create payment methods on Global Payments

  • Level 2 and Level 3 card data support for Global Payments

  • Gateway Options fields supported by Global Payments

  • Field mappings for credit card transactions through Global Payments

Last updated: December 3, 2025