> ## Documentation Index
> Fetch the complete documentation index at: https://help.eaglecart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Tabby Buy Now Pay Later in Eaglecart

> Set up Tabby in Eaglecart so customers can split orders into 4 interest-free payments. Add your merchant code and keys, set limits, test mode and product page messaging.

[Help Center](https://help.eaglecart.com/introduction.md)

[Payments](https://help.eaglecart.com/payments.md)

Set up Tabby

# Set up Tabby

Tabby is a buy now pay later service. Customers can split an order into 4 interest-free payments. In Eaglecart, Tabby is one of the **Additional payment methods**, and you set it up separately for each region.

## Where Tabby works

Tabby is available in Eaglecart for three countries, each with its own currency:

| Country | Currency |
| - | - |
| United Arab Emirates | AED |
| Saudi Arabia | SAR |
| Kuwait | KWD |

Tabby issues a merchant code for each country you sell in. The region's currency must match the country your Tabby credentials were issued for, or Tabby won't appear at checkout.

## Before you start

* You need an approved Tabby merchant account for the country you're setting up.
* In your Tabby Merchant Dashboard, under Developer settings, find your **Merchant code**, **Public key** and **Secret key**.
* Tabby gives you test keys and live keys. Use test keys to try things out and live keys to accept real payments.

## Set up Tabby

1. Go to **Settings → Payments** and select the region in **Regions**.
2. Under **Additional payment methods**, click **Tabby**.
3. Fill in **Checkout settings** and **API credentials** (described below).
4. Click **Save**.
5. When you're using live keys and ready to accept payments, activate Tabby for the region.

The page header shows the region (for example **AE**), Tabby's name, a **Test mode** badge while test keys are saved, and a **Manage** button that opens Tabby's site. While Tabby isn't active, a red banner reads "Tabby is not active in this region."

> [!WARNING]
>
> Before accepting real customer payments, make sure Tabby uses your live credentials. While test keys are saved, the page shows a **Test mode** warning: activate Tabby only after replacing them with your live keys.

## Checkout settings

"How Tabby appears to customers and when it is offered."

| Field | What it does |
| - | - |
| **Display name** | "Customers see this name when choosing a payment method at checkout." For example **Pay later with Tabby**. |
| **Description** | "Shown under the name at checkout." For example "Buy now, pay later. Split orders into 4 interest-free payments." |
| **Minimum order total** | The lowest order total for Tabby. Leave empty for no limit. |
| **Maximum order total** | "Hide Tabby when the order total is above this amount. Leave empty for no limit." |
| **Show Tabby on product and cart pages** | "Shows the instalment breakdown to customers before checkout." |

Both limits are compared with the order's product subtotal, before shipping and tax.

> [!NOTE]
>
> The hint under **Minimum order total** says Tabby is hidden when the order total is below this amount. Eaglecart's checkout rules describe Tabby as shown but greyed out below the minimum, with a message such as "Add AED 45.00 more to use this method." Test a cart below your minimum to see which applies in your store.

## API credentials

"Find these in your Tabby Merchant Dashboard under Developer settings."

| Field | What it is |
| - | - |
| **Merchant code** | "Issued by Tabby, one per country you sell in." |
| **Public key** | "Starts with pk\_ for live or pk\_test\_ for testing. Used for on-site messaging only." |
| **Secret key** | "Starts with sk\_ for live or sk\_test\_ for testing. Never shared with the browser." |

Saved keys are masked. Click the eye icon to show or hide them. Never share your secret key or include it in screenshots.

Below the keys, a line shows when Eaglecart last received a webhook event from Tabby, for example "Webhook event last received on 29 Sep, 2026 at 5:33 PM". Tabby sends these events to confirm payments in the background.

## Product and cart page messaging

With **Show Tabby on product and cart pages** turned on, Tabby's message ("4 interest-free payments of...") appears on:

* Product pages, below the add to cart area. It uses the price times the quantity, including paid options, and updates as the customer changes them.
* The cart page.
* The cart drawer, refreshed when it opens.

Your minimum and maximum order totals also filter the message on the cart page. Turn the toggle off to hide the message. If your store has no buy now pay later method set up, nothing from Tabby is loaded.

> [!NOTE]
>
> The instalment message is an advertisement, not an approval. Tabby decides whether to approve each customer when they check out.

## What customers see at checkout

1. Tabby appears in the payment list with your **Display name** and Tabby's logo.
2. When the customer selects it, your **Description** appears, or "You'll be redirected to Tabby to complete your purchase." if you left it empty. Tabby's own TabbyCard component also loads here.
3. The button reads **Pay with** followed by your display name, unless the name already starts with "pay", "checkout" or "buy". With **Pay later with Tabby**, the button shows the name as it is.
4. The customer completes the purchase on Tabby's page.
5. When they return, Eaglecart checks with Tabby that it's approved, then creates the order.

Tabby captures the payment when the order is placed, not when you ship it.

## When Tabby doesn't appear

Tabby is hidden at checkout when:

* It isn't set up or active for the customer's region.
* The region's currency doesn't match the country your Tabby credentials were issued for (AED for UAE, SAR for Saudi Arabia, KWD for Kuwait).
* The order is above your **Maximum order total**.

Below your **Minimum order total**, see the note above. Tabby can also decline a customer on its own page.

> [!NOTE]
>
> **Technical note:** To help Tabby make its decision, Eaglecart sends the order's items (name, quantity, unit price, SKU, barcode, image, whether it's refundable, and a category from the product's Google category, its collection, or "General"), the tax, shipping and discount amounts, and the customer's history with your store: registration date, number of completed orders and their last 10 orders. Repeat guests with the same email are recognised as the same customer. Tabby's TabbyCard script loads only when a customer selects Tabby; if it's blocked, checkout still works.

## Troubleshooting

**How do I enable Tabby?**
Save your live merchant code and keys on the Tabby page for the region, then activate it.

**Tabby is missing at checkout.**
Check that it's active for the customer's region, that the region's currency matches your Tabby account's country, and that the cart is within your limits.

**Which countries does Tabby support?**
United Arab Emirates (AED), Saudi Arabia (SAR) and Kuwait (KWD).

**The page still says Test mode.**
Your saved keys are test keys. Replace them with your live keys from Tabby and save.

**The webhook line shows an old date.**
Tabby hasn't sent recent events. Check your keys and contact Tabby if live payments aren't confirming.

## Related guides

* [Set up Tamara](https://help.eaglecart.com/payments/tamara.md): another buy now pay later option.
* [Payment methods at checkout](https://help.eaglecart.com/payments/checkout-payment-methods.md): available, greyed out and hidden methods.
* [Payment currencies and regional pricing](https://help.eaglecart.com/payments/payment-currencies.md): why currency decides whether Tabby appears.
* [Manage and deactivate payment methods](https://help.eaglecart.com/payments/manage-payment-methods.md): Localize, Deactivate and Delete.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.