Skip to main content

Set up and configure FiservIPG integration

Zuora

Set up and configure FiservIPG integration

  1. Last updated
  2. Save as PDF

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

Set up and configure a Fiserv IPG instance by using the information in this section, including prerequisites, configuration procedure, descriptions of the configuration fields, and references for testing the payment gateway.

Prerequisites

Procedure

Perform the following steps to set up and configure an Fiserv IPG instance in Zuora tenant:

  1. Click your username in the upper right and navigate to Settings > Payments > Setup Payment Gateway. 
  2. On the Payment Gateways page, click the Configure Gateway Instance tab and scroll to the bottom. 
  3. On the Configure Gateway Instance tab, select the payment gateway from the Gateway Type drop-down.
  4. From the Gateway Type list, select Fiserv IPG and click Create Gateway.
  5. Click Create Gateway.
  6. In the New Gateway page, specify values for the configuration fields. See below for more information on the fields. Note that not all the configuration fields 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. For more details on field descriptions, see the Configuration fields section. 
  7. Click Save Gateway Information.

Configuration fields

Basic Information

  • Name: Specify a name for the gateway instance.
  • Use Gateway Test Environment: When setting up the payment gateway integration, if you want Zuora to use the payment gateway's test service URL, select this checkbox.

Credentials

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

  • Store ID: A unique identifier assigned to your merchant account, or to a specific "store" or business unit within your organization.
  • Username: Your tenant-level user credentials for authentication.
  • Password: Your tenant-level user credentials for authentication (used for Basic authentication).
  • P12 File: Your tenant-level client certificate file (.p12) used for authentication.
  • P12 File Password: The passphrase for your tenant-level client certificate file (used for authentication).

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 that 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. 

Test the configuration

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