Skip to main content
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

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.” 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.” 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.
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.
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.