> ## 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 Tamara Buy Now Pay Later in Eaglecart

> Set up Tamara in Eaglecart for flexible interest-free payments. Add your API token, notification token and public key, switch between test and live mode, and set limits.

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

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

Set up Tamara

# Set up Tamara

Tamara is a buy now pay later service that lets customers split their purchase into flexible, interest-free payments. In Eaglecart, Tamara is one of the **Additional payment methods**, and you set it up separately for each region.

## Where Tamara works

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

The region's currency must match the country of your Tamara account, or Tamara won't appear at checkout.

## Before you start

* You need an approved Tamara merchant account.
* Tamara emails you three values when your account is approved: an **API token**, a **Notification token** and a **Public key**. They're also in the Tamara Partners Portal under API token management.
* Tamara issues one set of credentials for testing and a separate set for real payments.

## Set up Tamara

1. Go to **Settings → Payments** and select the region in **Regions**.
2. Under **Additional payment methods**, click **Tamara**.
3. Fill in **Checkout settings**.
4. Under **API credentials**, choose the **Mode** and enter that mode's credentials.
5. Click **Save**.

The page header shows the region (for example **AE**) and Tamara's name.

## Checkout settings

"How Tamara 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 **Tamara**. |
| **Description** | "Shown under the name at checkout." For example "Buy now, pay later with flexible, interest-free payments". |
| **Minimum order total** | "Below this amount Tamara is shown but cannot be selected, and the customer is told how much more to add. Leave empty for no limit." |
| **Maximum order total** | "Hide Tamara when the order total is above this amount. Leave empty for no limit." |
| **Show Tamara on product and cart pages** | "Shows the instalment breakdown to customers before checkout." |

Both limits are compared with the product subtotal, before shipping and tax. For example, with a minimum of AED 100 and a cart subtotal of AED 55, Tamara shows greyed out with a message like "Add AED 45.00 more to use this method."

## API credentials and mode

"Tamara emails these three values when your account is approved. They are also in the Tamara Partners Portal under API token management."

| Field | What it is |
| - | - |
| **Mode** | Choose test or **Live mode**. "Tamara issues one set of credentials for testing and a separate set for real payments. Both are kept here, so you can move between them without re-entering either." |
| **API token** | "Authorises your store to create and complete payments. Never shared with the browser." |
| **Notification token** | "Used to verify that payment notifications genuinely come from Tamara." |
| **Public key** | "Used for on-site messaging only." |

Each value is masked, with an eye icon to show or hide it. Never share these values or include them in screenshots.

### Switch between test and live mode

1. Open Tamara for the region.
2. In **Mode**, choose test mode or **Live mode**.
3. If that mode's credentials aren't saved yet, enter them.
4. Click **Save**.

Use test mode to try Tamara with Tamara's test credentials before going live. Use **Live mode** to accept real payments. Because both sets are kept, you can switch back to test mode later to reproduce a problem, then return to live.

> [!WARNING]
>
> Before accepting real customer payments, make sure Tamara is in **Live mode** with your live credentials. In test mode the page shows a badge and a warning, and the warning turns red if Tamara is offered at checkout while in test mode: real customers could place orders that will never be paid.

Tamara is hidden at checkout if the selected mode has no **API token** saved.

## Product and cart page messaging

With **Show Tamara on product and cart pages** turned on, Tamara's instalment message appears on product pages, the cart page and the cart drawer, updating as the customer changes quantity or paid options. Your minimum and maximum order totals also filter it on the cart page. Turn the toggle off to hide it.

The message isn't an approval. Tamara decides whether to approve each customer at checkout.

## What customers see at checkout

1. Tamara appears in the payment list with your **Display name** and Tamara's logo.
2. When selected, your **Description** appears, or "You'll be redirected to Tamara to complete your purchase." if it's empty.
3. The button reads **Pay with Tamara** (or your display name as it is, if it starts with "pay", "checkout" or "buy").
4. The customer completes the purchase on Tamara's page.
5. Eaglecart checks the result with Tamara and creates the order.

## How a Tamara payment moves through its stages

Tamara uses three stages, which all happen in one pass at checkout:

1. **Approved:** the customer has completed the purchase with Tamara.
2. **Authorised:** Eaglecart acknowledges the approval to Tamara.
3. **Captured:** the payment is captured. Only captured orders settle to you.

These are Tamara's stages, not your order's payment status in Eaglecart. See [Understanding payment statuses](https://help.eaglecart.com/payments/payment-statuses.md).

> [!NOTE]
>
> **Technical note:** Eaglecart sends Tamara each item's details and type (**Physical**, or **Digital** if the product has a download attached), the payment amount, customer and order information, and risk assessment details (registration date, order count and whether they're an existing customer). Tamara uses these in its decision.

## When Tamara doesn't appear

* It isn't set up or active for the customer's region.
* The region's currency doesn't match your Tamara account's country (SAR for Saudi Arabia, AED for UAE).
* The selected **Mode** has no **API token**.
* The order is above your **Maximum order total**.

## Troubleshooting

**How do I enable Tamara?**
Enter your credentials for the right mode, choose **Live mode** for real payments, save, and make sure Tamara is active for the region.

**How do I switch Tamara between test and live mode?**
Change **Mode** and click **Save**. Both credential sets stay saved.

**Tamara is greyed out at checkout.**
The cart's product subtotal is below your **Minimum order total**. The customer sees how much more to add.

**Tamara disappeared after switching mode.**
The new mode has no **API token**. Enter it and save.

## Related guides

* [Set up Tabby](https://help.eaglecart.com/payments/tabby.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): currency rules for buy now pay later.
* [Manage and deactivate payment methods](https://help.eaglecart.com/payments/manage-payment-methods.md): sequence, Localize, Deactivate and Delete.


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