Skip to main content

First Data Gateway


First Data Gateway

First Data is a provider of electronic commerce and payment solutions. 

To set up the First Data PMU service in Zuora, see Configure First Data Payment Method Updater for more information.

Configure the First Data Gateway

  1. Click your username at the top right and navigate to Settings > Payments > Setup Payment Gateway
  2. Select FirstData GGe4 v14 from the Gateway Type drop-down menu.
  3. Click create gateway.

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.

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.
  • 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)

Once you have entered the necessary information, click save gateway information.

Testing Your Configuration 

We recommend that you test your payment gateway by using both your payment gateway's test and production (live) environments.  Once you have completed testing in the gateway's test environment, it is recommended that you perform a test in your live production environment with a real credit card. If there are any differences in the configuration of your testing and production accounts, testing in production ensures your production merchant account is set up properly and can successfully connect to the production environment.

You can use the test cards and scenarios provided by the gateway vendor to test your integration. See this article on First Data site for details.