Skip to main content

Set up and configure a First Data gateway instance

Zuora

Set up and configure a First Data gateway instance

  1. Last updated
  2. Save as PDF

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.

Procedure 

Perform the following steps to set up and configure a First Data gateway instance in Zuora:

  1. Click your username in the upper right and navigate to Settings > Payments > Setup Payment Gateway. 
  2. On the Configure Gateway Instance tab, select FirstData GGe4 v14 from the Gateway Type drop-down list.
  3. Click Create Gateway.
  4. On the gateway settings page, specify values for the configuration fields. 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.

Configuration fields

Common 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)

Specific configuration fields

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.