Skip to main content
Fat Zebra is an Australian payment gateway with global reach across 40+ countries. Connect Fat Zebra to Primer to process card payments, Apple Pay, Google Pay, and EFTPOS, and route them using Workflows.

​
At a glance

​
Supported payment methods

Fat Zebra uses Primer’s standard card form and Primer’s native Apple Pay and Google Pay integrations, so no Fat Zebra-specific SDK code is required.

​
Supported capabilities

​
3D Secure

Primer performs 3D Secure authentication using the Perform 3DS action and passes the result to Fat Zebra. Fat Zebra does not run its own 3D Secure for payments processed through Primer.

​
Get started with Fat Zebra

​
Before you begin

If this is your first connection, make sure to follow the Get started guide to begin processing payments with Primer. You need a Fat Zebra sandbox account for testing and a separate production account. Contact Fat Zebra to provision both.
Before going live, ask Fat Zebra support to enable separate Authentication and Capture on your production account. This is required for 3DS to work correctly with Primer.

​
Credentials

Fat Zebra provides your credentials on account setup.

​
Configure in the Dashboard

1

Add Fat Zebra to your Dashboard

Go to Integrations, select New integration, search for Fat Zebra, and enter your Username and Token password.
2

Activate the payment methods on the Checkout

Go to Checkout and activate the payment methods you want to offer.
3

Route payments with Workflows

In Workflows, select Fat Zebra in the Authorize payment action. Add the Perform 3DS action before authorization for card payments.

​
Prepare the client session

No additional fields are required beyond the standard orderId, currencyCode, amount, and customer fields.

​
Considerations

  • Australia-primary processor. Fat Zebra’s core market is Australia. Confirm currency and country support with Fat Zebra for other markets before going live.
  • Dynamic response codes in sandbox. The last two digits of the purchase amount control the response code (for example, AUD $50.09 returns response code 09). Use the designated test card numbers for straightforward approve or decline testing.
  • Click to Pay test cards. Only the designated Mastercard test card numbers work for Click to Pay in sandbox — arbitrary PANs cause the challenge to fail.
  • Sandbox credentials begin with TEST. Using sandbox credentials in production (or vice versa) will fail.

​
Test in sandbox

Connect your Fat Zebra test account (credentials begin with TEST) to your Primer Sandbox environment.
Use the following test cards. These cards trigger specific 3DS outcomes regardless of the purchase amount.

​
Go live

Before switching to production, confirm that:
  1. Fat Zebra support has enabled separate Authentication and Capture on your production account.
  2. You have added Fat Zebra in your Primer production environment using your production Username and Token password (not TEST credentials).
  3. The target currencies and countries are enabled on your Fat Zebra account.