WooCommerce Development

Tamara and Tabby on WooCommerce: BNPL Setup for Saudi Arabia and the UAE

Updated October 30, 2026 8 min read
Tamara and Tabby on WooCommerce: BNPL Setup for Saudi Arabia and the UAE

Tamara and Tabby are the two buy now, pay later providers most Saudi and UAE stores consider, and both have a free official WooCommerce plugin in the WordPress.org directory. You install the plugin, enter the credentials the provider sends you, and the method appears at checkout. Both providers have to approve your store first.

The two plugins work differently once an order exists. With Tamara, an order only settles to your account after you capture it, and the plugin does that when you move the order to a shipped or completed status. With Tabby, you enter a public and a secret key, and the plugin sends order data when an order is captured, cancelled or refunded. This guide covers the setup, the order flow and the checks to run before launch.

Written from the providers’ official documentation and the WordPress.org plugin listings as read on 30 October 2026. I have not tested these plugins against a live merchant account, so confirm details with your account manager before launch.

How do Tamara and Tabby compare on WooCommerce?

Tamara Tabby
Plugin name Tamara Checkout (version 1.9.9.24) Tabby Checkout (version 5.16.1)
Active installs 3,000+ 4,000+
Where the settings live WooCommerce, Settings, Payments, Tamara Gateway WooCommerce, Settings, Tabby API, plus the “Pay later with Tabby” method under Payments
Credentials Merchant API token, notification token and a public key for widgets Public API key and secret API key
Markets named in the plugin or docs Checkout shows only for Saudi Arabia or UAE billing countries (changelog 1.9.9.22) KSA and UAE, with currency matched to the country (SAR for KSA, AED for the UAE)
HPOS Not mentioned on the plugin page Supported since version 5.6.0
Block checkout Not mentioned on the plugin page Supported

Tamara’s own site lists Kuwait and Bahrain among its countries, and its changelog mentions Kuwaiti and Bahraini dinar options, but the plugin currently shows checkout only for Saudi and UAE billing countries. If you sell in Kuwait or Bahrain, ask Tamara and Tabby what your account supports instead of assuming.

What do you need before you install either plugin?

Neither provider lets you self-activate. For Tamara, you sign up as a Tamara partner, and applications may join a waiting list, with Tamara contacting you within a few business days according to its WooCommerce page. For Tabby, you register in the Tabby merchant dashboard, complete your business details and get your API keys. Use the Saudi merchant dashboard if you operate in Saudi Arabia.

Plan your stack before you apply: the store must run over HTTPS and bill in the right currency for each country. Both plugins add themselves as separate WooCommerce payment methods, so they can sit next to mada, cards and each other.

How do you set up Tabby on WooCommerce?

Tabby’s documentation gives these steps:

  1. Register with Tabby and complete your business details to get your keys.
  2. Install the plugin from the WordPress directory, or upload the zip under Plugins, Add New, Upload plugin, then activate it.
  3. Go to WooCommerce, Settings, Tabby API and enter the Public API Key and the Secret API Key. Save.
  4. Go to WooCommerce, Settings, Payments and enable “Pay later with Tabby”.
  5. Enable auto-updates for the plugin, and re-save your Tabby settings after each update, as the plugin listing recommends.

How do you test Tabby?

Tabby’s documentation says testing is performed on production keys. You add a product, go to checkout, enter the Tabby test credentials for your country, confirm that you are redirected to the Tabby hosted payment page, and then go back to the store and confirm the cancellation returns you to checkout. You cannot complete a payment, because the keys are live. If you need separate testing keys, ask Tabby’s partner team.

Why is Tabby not showing at checkout?

Work through the list from Tabby’s docs:

  • The right countries are enabled under Allowed Countries in the Tabby API settings.
  • “Pay later with Tabby” is enabled under Payments.
  • The country and currency pair is correct, for example UAE with AED and KSA with SAR. Multi-currency stores need a currency switcher.
  • Plugin mode is set to “Payment gateway”. The “Promo only” mode shows product and cart snippets without offering Tabby at checkout.

What does the Tabby plugin send out?

The plugin listing says the product catalogue feature has been on by default since version 5.0.0, and that store insights are on by default and can be switched off in the Tabby API settings. The listing also says technical logs and anonymised order statistics go to a monitoring service, and that customer names, emails, phones and addresses are not sent. Review this with whoever owns your privacy policy before launch.

How do you set up Tamara on WooCommerce?

Tamara’s installation and configuration pages give these steps:

  1. Install Tamara Checkout from Plugins, Add New, or upload the package, then activate it. The Tamara Gateway then appears under WooCommerce, Settings, Payments.
  2. Click Manage and tick Enable, so Tamara shows as a payment method at checkout.
  3. Choose the working mode. Sandbox is for testing only, and Live is for real transactions after Tamara gives you live credentials.
  4. Enter the API (merchant) token and the notification token. Tamara emails separate sandbox and live versions of each. The live notification token is for use once Tamara’s team has given the go-ahead.
  5. Enter the public key, which the plugin needs to generate the product, cart and checkout widgets.

The API URLs are https://api-sandbox.tamara.co for sandbox and https://api.tamara.co for live. Enter an incorrect token and the plugin disables itself and shows an incorrect-credentials error, so check the token first if Tamara disappears after you save.

How does Tamara order management work in WooCommerce?

The default mapping is simple, and getting paid depends on it:

WooCommerce status Tamara result
Processing Authorised, which means Tamara validated the order
Completed (shipped) Captured, through a capture API call
Cancelled Canceled, through a cancel API call, and only before the order is completed
Refunded Fully refunded, through a refund API call

Tamara warns that orders that are not captured will not be settled to your account in your next settlement cycle. Partial refunds need a captured order, and the order stays completed unless every item is refunded. Tamara’s order status flow adds time limits: checkout must finish within 30 minutes of creating the session, an order not authorised within 72 hours expires, and an authorised order not captured within 21 days is auto-captured. An authorised order that is neither captured nor cancelled within 90 days expires.

Is the Tamara plugin safe to run?

Update it. Changelog version 1.9.9.21 fixed unauthenticated order status changes on the cancel and fail endpoints by adding order key and request signature checks. The version listed on WordPress.org on 30 October 2026 is 1.9.9.24, so a store on anything older than 1.9.9.21 should update first.

What should you test before launch?

Tamara’s online go-live checklist is a good template for both providers. Run these cases on a staging store and then once on production:

  • Tamara or Tabby appears only for eligible customers and only when the cart total is inside your account’s minimum and maximum limits.
  • The checkout language matches the store, in English and Arabic.
  • Success, cancellation and failure all redirect the customer to the right page.
  • A declined payment, using the provider’s test cases, leaves a sensible order and message.
  • Status changes reach the provider: capture on shipment, full and partial cancellation, and full and partial refunds.
  • Tamara orders are refunded only through Tamara, never to a store wallet.
  • Widgets look right on desktop and mobile, and logos match the provider’s brand kit.

Should you offer both Tamara and Tabby?

Both plugins register separate payment methods, so offering both is technically easy. The business question is different: each provider has its own approval, settlement terms and fees, and each is one more method to test after every WooCommerce update. Ask both for their commercial terms in writing, start with the one that approves you first, and add the second when you have data on which one shoppers choose.

Frequently asked questions

Do Tamara and Tabby work in Kuwait?

Tamara’s Kuwait site page lists Kuwait and Bahrain, but the plugin currently shows checkout only for Saudi and UAE billing countries. Tabby’s WooCommerce documentation names KSA and the UAE. Ask each provider what your account supports.

Why are my Tamara orders not paid out?

Most likely they were never captured. Tamara only settles captured orders, so make sure your shipped or completed status triggers the capture call.

Can I test Tabby without taking a real payment?

Yes, and by design you cannot complete the payment, because Tabby’s documented test flow uses production keys and stops at the hosted payment page.

Do these plugins support HPOS and the block checkout?

The Tabby plugin lists HPOS support since version 5.6.0 and block checkout support. The Tamara plugin page does not mention either, so test them on staging.

Does buy now pay later change the invoice I have to issue?

The plugin does not issue invoices. If you sell in Saudi Arabia, read the ZATCA e-invoicing guide, and for B2B sales in the UAE read the UAE e-invoicing guide.

Taking cards, KNET or mada through one provider? See MyFatoorah for WooCommerce.

Need help with a Saudi or UAE WooCommerce checkout?

A short technical assessment covers your checkout, payment methods, order statuses and the capture and refund flow. See my WooCommerce developer service, the payment gateway comparison for the Gulf and the other WooCommerce Gulf guides.

Sources

Have a WordPress project or problem to solve?

Book a short call and I will help make it shippable — from a quick fix to a full custom build.

Book a call

Related articles