Skip to main content

Set up and configure a Fat Zebra payment gateway instance

Zuora

Set up and configure a Fat Zebra payment gateway instance

  1. Last updated
  2. Save as PDF

Set up and configure a Fat Zebra gateway instance by using the information in this section.

Prerequisites

  1. The following credentials are required for configuring the Fat Zebra payment gateway instance in Zuora. Retrieve or generate them from the Fat Zebra Merchant Dashboard:
    1. Retrieve the following credentials from the dashboard:
      • Username 
      • API Token 
      • Shared Secret
    2. Generate the following tokens by following these instructions in Fat Zebra's documentation:
      • Access Key
      • Access Secret key
  2. Enable the Fat Zebra payment gateway integration for your tenant. See Enable payment gateway integrations for your tenant for instructions.

Procedure

Take the following steps to create and configure a Fat Zebra payment gateway instance in Zuora:

  1. Navigate to Settings > Payments > Setup Payment Gateway. 
  2. On the Configure Gateway Instance tab, select Fat Zebra from the Gateway Type drop-down menu.
  3. Click Create Gateway.
  4. On the gateway settings page, specify values for the configuration fields, and then click Save Gateway Information. For details about the fields, see "Configuration fields" in the following section.

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

Retrieve or generate the following credentials from the Fat Zebra Merchant Dashboard:

  • Username
  • API Token
  • Access Key
  • Access Secret
  • Shared Secret

See Prerequisites for more information.

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 the 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.
  • Verify new payment method: Select this checkbox to verify the payment methods when creating them. By default, this checkbox is selected. For tokenized payment methods, you must validate them in Zuora so that payments made with these payment methods are successful.
  • Verify updated payment method: Select this checkbox to verify the payment methods when updating them. By default, this checkbox is selected. For tokenized payment methods, you must validate them in Zuora so that payments made with these payment methods are successful.
  • Transaction Source: Select the source of the transaction: Mail Order, Telephone Order, or Internet.
  • Merchant Transaction Reason: Select the reason for initiating a merchant-initiated transaction.
  • Omit Expiry for Recurring Transactions: Select this checkbox to send recurring transactions to the banking network without the expiry date field.

Test the configuration

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

For information about test cards and accounts provided by Fat Zebra, see Fat Zebra's documentation.