Skip to main content

Set up and configure a First Data UCom gateway instance

Zuora

Set up and configure a First Data UCom gateway instance

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

Prerequisites

Enable the First Data UCom 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 UCom instance.

  1. Navigate to Settings > Payments > Setup Payment Gateway
  2. On the Configure Gateway Instance tab, select FirstData UCom from the Gateway Type drop-down list.
  3. Click create gateway.
  4. In the New Gateway configuration page, specify values for the gateway configuration fields.
  5. Click save gateway configuration.

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 checkbox 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 American Express payments, a minimum of $1.00 is required. 
  • Verify new payment method (optional): With this checkbox selected, the validate call is triggered for any supported payment method when a new payment method is created. 
  • Verify updated payment method (optional): With this checkbox selected, the validate call is triggered for any supported payment method when an existing payment method is updated.

Credential fields

You must contact FirstData to obtain the Token, API Key, and API Secret prior to setting up the FirstData UCom gateway. 

  • API Key: The API Key is a unique identifier used to determine API access right for the FirstData merchant account.
  • API Secret: The secret key is an encryption/decryption key unique to the merchant account and is used to receive or retrieve data.
  • Merchant Id: Merchant Identifier for the order related to the requested authorization.
  • Encryption Certificate: The certificate file is provided by First Data. A password is required to open the file.