Tabby and Tamara on Shopify UAE: Setup Guide (2026)

Why You Probably Want Both, Not One

We've already covered why Shopify Payments doesn't work in the UAE and how to think about BNPL across the Gulf. This post is the practical follow-up: a step-by-step setup guide for adding both Tabby and Tamara to a Shopify store operating in the UAE, the configurations that trip merchants up, and the widget placements that actually move conversion.

The short version on the “which one” question: most UAE Shopify stores doing AED 50k+/month should offer both. Tabby and Tamara split the local audience roughly evenly, and customers tend to have an existing relationship with one of the two. Forcing them onto the other costs you the sale. Installation is free for both, so the only cost is the MDR on the transactions that actually convert through BNPL, which are transactions you probably weren't going to win otherwise.

What You Need Before You Start

Both Tabby and Tamara require commercial onboarding before the Shopify app will function in production. The merchant portal grants you the API credentials, but only after a quick eligibility review.

• Active UAE trade licence (mainland, free zone, or e-commerce licence all work)
• UAE bank account for settlements (in the company name)
• Shopify Basic or higher (Lite/Starter cannot install third-party payment apps)
• A staging or test environment, or a willingness to test on the live store with Tabby's sandbox mode
• KYC documents ready: trade licence, Emirates ID of authorised signatory, MOA, recent bank statement (3 months)

Tabby's onboarding typically clears in 2–3 business days. Tamara's is closer to 5–7. Start both applications in parallel the day you decide to add BNPL. The fastest path to live BNPL is calendar time, not configuration time.

Setting Up Tabby on Shopify UAE

Tabby ships an official Shopify app. The setup runs through the Tabby merchant portal, then back to Shopify Admin to enable the payment method.

1. Install the Tabby app from the Shopify App Store. Search “Tabby” in the Shopify App Store, click Add app, approve permissions.
2. Open the Tabby app inside Shopify Admin. You'll land on a screen asking for Public Key and Secret Key.
3. Pull credentials from the Tabby merchant portal. Log in to merchant.tabby.ai, go to Settings → API Credentials, copy both keys. You'll see separate sandbox and production keys. Use sandbox first.
4. Paste keys into the Shopify app and select market: UAE (AED). If you serve multiple GCC markets, you can add Saudi (SAR) and Kuwait (KWD) on the same setup. Tabby handles currency conversion at checkout based on the customer's billing address.
5. Enable Tabby in Shopify's payment settings. Go to Settings → Payments → Alternative payment methods → Activate Tabby. If you don't see Tabby in the list, refresh the page; if it still isn't there, the API keys didn't save.
6. Place a test order in sandbox. Use Tabby's test card numbers to confirm checkout, payment plans, and webhooks all fire.
7. Switch to production keys. Replace sandbox keys with production keys in the Shopify app. Place one real low-value order (AED 30 or so) to confirm end-to-end before promoting the widget.

Setting Up Tamara on Shopify UAE

Tamara's Shopify integration follows a similar pattern, with one extra step: you'll get a single Merchant Token rather than a public/secret pair.

1. Install the Tamara app from the Shopify App Store. Tamara is published by Tamara itself, not a third party. Install, approve permissions.
2. Get your Merchant Token from the Tamara merchant portal. Log in to partners.tamara.co, go to Integration → Shopify, copy the token. Sandbox and production tokens are issued separately.
3. Paste the token into the Shopify Tamara app and select markets. Tamara supports UAE, Saudi Arabia, Kuwait, and Bahrain. Enable every market you have a licence for. Configure both Pay in 2 and Pay in 4 if you want maximum customer flexibility.
4. Enable Tamara in Shopify payments. Same path as Tabby: Settings → Payments → Alternative payment methods → Activate Tamara.
5. Sandbox test, then production test. Use Tamara's test phone numbers (documented in the merchant portal) to simulate the checkout flow. Confirm the success page, order webhook, and the entry in Shopify's Orders list before going live.
6. Verify settlement schedule with your Tamara account manager. Default is T+7 weekdays. If you need faster settlement for cash flow, Tamara can sometimes negotiate this during onboarding.

Widget Placement: Where Conversion Actually Happens

Activating the payment method only gets you the checkout step. To recover the cart-abandonment dollars BNPL is designed to capture, you also need the widget on product and cart pages so customers see “or 4 payments of AED 125” next to the price before they decide to keep shopping.

Both apps add widgets automatically to most modern Shopify themes (Dawn, Sense, Refresh, Studio). For older themes or heavily customised ones, you'll need to drop the snippets into the Liquid templates yourself.

Recommended placement order:

• Product page, directly under the price. Highest impact. Customers see the split before they decide whether they can afford the item.
• Cart page, near the subtotal. Second-best position. Catches customers who are comparing total spend.
• Checkout (automatic via the payment method activation, no manual placement needed).
• Mini-cart drawer if your theme has one. Easy to miss in setup. Add it.

For a custom theme, paste this into sections/product-template.liquid right after the price block (Tabby example, Tamara has an equivalent snippet in their docs):

<div id="tabby-promo"></div>
<script src="https://checkout.tabby.ai/tabby-promo.js"></script>
<script>
  new TabbyPromo({
    selector: "#tabby-promo",
    currency: "AED",
    price: {{ product.price | money_without_currency }},
    lang: "{{ shop.locale }}",
    source: "product",
    publicKey: "YOUR_PUBLIC_KEY"
  });
</script>

Multi-Market Setup: UAE, Saudi, Kuwait, Bahrain

If your Shopify store serves more than one GCC market, both Tabby and Tamara support multi-currency on a single integration. The catch: you need a trade licence in each country you process payments in, and the payment method will only appear at checkout when the customer's billing address matches an enabled market.

Tabby currently covers UAE (AED), Saudi (SAR), and Kuwait (KWD). Tamara covers UAE (AED), Saudi (SAR), Kuwait (KWD), and Bahrain (BHD). For Qatar, neither has launched as of mid-2026; the roadmap suggests both will arrive within 12 months. Plan accordingly if Qatar is core to your business.

For Saudi Arabia specifically, you'll also need to verify ZATCA e-invoicing compatibility. Both Tabby and Tamara generate compliant invoices, but the line-item data needs to be passed through correctly from Shopify. If your store uses heavy custom line items or bundles, test the invoice output before launch.

Fees and Settlement: Tabby vs Tamara Side-by-Side

Exact MDR is negotiated per merchant. Public-list numbers as of mid-2026, for context:

Negotiate your MDR. Stores with AED 100k+/month in card volume can usually pull list rates down by 0.5–1 percentage point. The argument that works: predictable volume, low refund rates, no chargebacks on BNPL (the BNPL provider absorbs them).

Common Errors and the Fix for Each

• “Tabby/Tamara not appearing in Alternative payment methods” — API keys or merchant token didn't save. Open the app, paste again, hit save, then refresh Shopify's Payments page.
• “Payment method available but checkout fails” — You're still on sandbox keys in production. Swap to production keys in the app, place a test order to confirm.
• “Widget shows wrong currency” — Shopify's default currency is mismatched with the BNPL market. In Shopify, go to Settings → Markets, ensure UAE is set up as a primary or secondary market with AED as the presentment currency.
• “Customer reports the BNPL option disappeared at checkout” — Cart total fell below the minimum (AED 100) after a discount. Either lower the minimum in the BNPL portal or set up a Shopify rule that hides discount codes when BNPL is the chosen method.
• “Tabby works but Tamara doesn't (or vice-versa)” — Almost always a permissions issue. Reinstall the failing app, paste credentials fresh, and check the merchant portal for an “account status: pending” flag.
• “Orders show as paid in Shopify but aren't in the BNPL portal” — Webhook URL was misconfigured during setup. The BNPL apps install webhooks automatically; if they fail, both apps include a “Reset webhooks” button in their settings.

When BNPL Doesn't Fit Your Shopify Store

BNPL adds conversion for fashion, beauty, electronics, home goods, and any considered purchase between AED 200 and AED 5,000. It rarely makes sense for:

• B2B stores where the payer is a business, not a consumer. Tabby and Tamara both require individual buyer KYC.
• Subscription or recurring billing. Both apps support one-time purchases only as of mid-2026.
• Average order value under AED 100 or over AED 7,500. Outside this band, you're paying the BNPL fee without the conversion lift.
• Stores with high return rates (above 25%). Returns are operationally messy across BNPL: the customer's instalment plan needs unwinding alongside the refund, and dispute resolution adds days.
• Regulated categories (alcohol, certain financial services, pharma). Both providers screen and may decline merchant onboarding.

Pre-Launch Checklist

Before you announce BNPL to your customer list, run this checklist.

• Sandbox test passed for both Tabby and Tamara, including refund flow
• One real low-value live order placed on each, fully refunded after confirmation
• Widget visible on product, cart, mini-cart, and checkout (test on iOS Safari and Android Chrome)
• Arabic locale tested if you serve Arabic-speaking customers
• Settlement bank account confirmed in both merchant portals
• Operations team trained on the refund flow specific to each provider
• FAQ page on your store explaining how BNPL works to customers
• Email + WhatsApp templates ready for customers who get confused

Once all eight are ticked, you're ready to promote. The conversion lift typically shows up in week one. If it doesn't, check the widget actually rendered (you'd be surprised how often that gets missed) and that the minimum-order threshold isn't hiding the option on most carts.

The Bottom Line

For a typical UAE Shopify store doing AED 50k+/month, adding both Tabby and Tamara takes about a week of calendar time and a few hours of hands-on configuration. The conversion lift averages 12–18% on stores we've set this up for. The average order value lift is independently 15–22%, because customers who would have bought one item end up buying two when the instalment makes the second one feel free.

If you want help with the integration, the widget customisation, or the wider Shopify build, our e-commerce team runs this setup as part of a standard Shopify UAE launch. Or if you prefer a one-off review of an existing store, get in touch for a free audit. We respond within 24 hours.