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

Overview of First Data gateway integration

Set up and configure a First Data gateway instance

Learn how to set up and configure a First Data gateway instance, including configuration procedures, field descriptions, and testing references.

Set up and configure a First Data gateway instance by using the information in this article, including configuration procedure, descriptions of the configuration fields, and reference for testing the payment gateway.

Prerequisites

Enable the First Data payment gateway integration for your tenant. See Enable payment gateway integrations for your tenant for instructions.

Configuration fields

There are some common fields you must complete for every gateway configuration. We recommend reviewing Setting Up Payment Gateways for information on these fields.

  • Name : Choose a name that identifies this payment gateway. We recommend using a name that helps your users identify the gateway.

  • Use Gateway Test Environment : Select this check box if you want Billing to use the payment gateway's test service URL. This allows you to test payment transactions while you are setting up your Billing.

  • Cards Accepted : Select the credit cards that you accept.

  • Default Authorization Amount : The minimum default amount used to process a payment. For AMEX payments a minimum of $1.00 is required.

  • Verify new payment method (optional)

  • Verify updated payment method (optional)

Note:

Login to your First Data Global Gateway Account for more information on creating your Key ID and HMAC Key for your merchant account.

  • Gateway ID : The API Key is a unique identifier used to determine API access right for the FirstData merchant account.

  • Password : The secret key is an encryption/decryption key unique to the merchant account and is used to receive or retrieve data.

  • Key ID : The Key ID is an access key containing 3-5 numbers.

  • HMAC Key : This is the 32 character hash message authentication code generated by FirstData for your merchant account.

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 cards and scenarios provided by the gateway vendor to test your integration.

Overview of First Data gateway integration

Last updated: December 3, 2025