Skip to main content

Overview of Fat Zebra payment gateway integration

Zuora

Overview of Fat Zebra payment gateway integration

Zuora integrates with the Fat Zebra payments API, supporting a gateway integration known as Fat Zebra.

Supported features

The following table provides a quick reference for the supported features.

Supported payment methods
  • Credit Card/Debit Card
  • Direct Entry AU
  • Apple Pay 
  • Google Pay
Supported payment operations 
  • Validate
  • Payment
  • Payment cancel (only for Credit Card)
  • Referenced refund 
  • Non-referenced refund
Support 3D Secure 2.0 Yes
Support Delayed Capture Yes
Support Level 2 and Level 3 card data No
Support stored credential transactions Yes
Support Gateway Options fields No
Gateway provider’s API version V1
Gatetway provider’s  production endpoint used for Zuora gateway integration service https://gateway.pmnts.io/
Support Batch Gateway Reconciliation No
Support Real-Time Reconciliation Yes (Direct Entry AU only)
Support Payment Method Updater No
Support inquiry call for retrying a transaction request Yes (in payments, payment cancel, referenced refunds, and non-referenced refunds)

Supported payment methods

The Fat Zebra payment gateway integration supports the following payment methods:

  • Credit Card and Debit Card
    • American Express
    • Diners Club
    • Discover
    • JCB
    • MasterCard
    • Visa
  • Direct Entry AU
  • Apple Pay 
  • Google Pay

You can create these payment methods on the Fat Zebra gateway integration through Payment Pages 2.0. Creation of payment methods through the API operations or Zuora UI is not supported.

You can also implement a one-time payment flow to process a payment, with the option to create a payment method in Zuora or not. For the payment methods stored in Zuora, a token is saved and used to process recurring payments.

For supported currencies, see Fat Zebra's documentation.

Apple Pay 

FatZebra provides support for Apple Pay. For more information about setting up Apple Pay, see Set up Apple Pay.

Support for Delayed Capture

The Delayed Capture feature allows you to authorize the availability of funds for a transaction but delay the capture of funds until a later time. The Fat Zebra payment gateway integration supports Delayed Capture for Credit Card payment methods, which involves the use of the following API operations:

Zuora also supports capturing authorizations that were generated externally by using Zuora's Create authorization API operation.

Support for stored credential profiles

The Fat Zebra payment gateway integration includes support for the Stored Credential Transactions framework. For details, see Support for stored credential transactions overview.

Support for Real-Time Reconciliation

The Fat Zebra payment gateway integration supports the Real-Time Reconciliation feature for Direct Entry AU transactions. With this feature enabled, the payment gateway submits notifications to Zuora for payment and refund events and corresponding records can be automatically updated in real-time.

For more information, see the following articles:

Support for Tokens Provisioned Outside Zuora and FatZebra

The Fat Zebra payment gateway integration supports payment operations using the network tokens provisioned outside Zuora and FatZebra. The following API operations currently support this feature:

  • Create a payment method
  • Verify a payment method
  • Create authorization
  • Create a payment

Merchants can process transactions using FatZebra using the Network Token and associated expiry details, along with Cryptogram if it is made available and mandatory. 

Zuora will not validate if Cryptogram is required for transactions, and hence, merchants must ensure Cryptogram is supplied wherever it is applicable. The Cryptogram is not stored if the payment method gets saved, and may not be required depending on the use case