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
- Go to Settings → Payments and select the region in Regions.
- Under Additional payment methods, click Tamara.
- Fill in Checkout settings.
- Under API credentials, choose the Mode and enter that mode’s credentials.
- Click Save.
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
- Open Tamara for the region.
- In Mode, choose test mode or Live mode.
- If that mode’s credentials aren’t saved yet, enter them.
- Click Save.
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
- Tamara appears in the payment list with your Display name and Tamara’s logo.
- When selected, your Description appears, or “You’ll be redirected to Tamara to complete your purchase.” if it’s empty.
- The button reads Pay with Tamara (or your display name as it is, if it starts with “pay”, “checkout” or “buy”).
- The customer completes the purchase on Tamara’s page.
- 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:- Approved: the customer has completed the purchase with Tamara.
- Authorised: Eaglecart acknowledges the approval to Tamara.
- Captured: the payment is captured. Only captured orders settle to you.
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: another buy now pay later option.
- Payment methods at checkout: available, greyed out and hidden methods.
- Payment currencies and regional pricing: currency rules for buy now pay later.
- Manage and deactivate payment methods: sequence, Localize, Deactivate and Delete.
