How to Add Tabby and Tamara BNPL to Your Shopify Store [UAE Guide]

UAE shoppers expect Buy Now, Pay Later at checkout. It's not a feature you offer to stand out anymore — it's one you're penalized for not offering. The BNPL market in the UAE is projected to grow from $2.07 billion in 2023 to $4.41 billion by 2029, driven heavily by the 18–35 demographic that makes up a significant portion of online shoppers.

Tabby and Tamara are the two dominant BNPL providers in the UAE. For Shopify merchants, the good news is that both offer official Shopify app integrations. The bad news is that most implementation guides stop at "install the app" — and the stores that just install the app see minimal lift.

The lift comes from where you put the widgets.

This guide walks through the complete installation of both Tabby and Tamara on a Shopify store, the configuration that actually moves conversion metrics, and the gotchas we've encountered building UAE Shopify stores as a Shopify Partner.

---

What You'll Learn

• How Tabby and Tamara work (and the difference between them)
• Prerequisites before you apply for merchant accounts
• Step-by-step installation for both apps on Shopify
• Widget placement strategy: PDP, cart, and checkout
• Test mode setup and how to run end-to-end test transactions
• Common errors and how to fix them
• The AOV optimization layer most stores miss

---

Prerequisites

Before you start the installation, you need to have the following in place:

For both Tabby and Tamara:

• A valid UAE, Saudi Arabia, or Kuwait trade license
• A corporate bank account in the same country as your trade license
• A live (or near-live) Shopify store URL
• An SSL certificate on your domain (Shopify provides this automatically)
• Products priced within BNPL eligibility ranges (more on this below)

For Tabby specifically:

• Your store must primarily serve UAE, KSA, or Kuwait billing addresses. Tabby only processes orders from these three markets.

For Tamara specifically:

• Tamara operates in UAE, Saudi Arabia, Kuwait, and Bahrain. Similar market restrictions apply.

If you don't have a UAE trade license yet, read our guide on how to start an ecommerce business in Dubai first — getting the gateway approved before the business is legally registered is a common sequencing mistake.

---

Understanding the BNPL Model (Important Before You Apply)

Before integrating, understand exactly how the commercial model works:

For your customers: They split the purchase into 4 equal interest-free installments. For Tabby, 25% is paid upfront at checkout; the remaining 3 payments are auto-debited every 2 weeks or monthly, depending on the plan. For Tamara, options include 2-part or 4-part payments.

For you as the merchant: You receive the full purchase amount upfront. Tabby and Tamara assume the collection risk. Your cost is the merchant discount rate (MDR) — typically 3–6% per transaction, depending on your agreement and monthly volume.

Order eligibility ranges:

• Tabby: typically eligible for orders between AED 100 and AED 5,000 (thresholds confirmed at merchant onboarding)
• Tamara: similar ranges; confirm specific thresholds during merchant application

Orders below the minimum or above the maximum won't display the BNPL option. Configure your widget display logic accordingly.

---

Part 1: Installing Tabby on Shopify

Step 1: Apply for a Tabby Merchant Account

1. Go to tabby.ai and click Become a Partner or Merchant Sign Up.
2. Fill in your business details: trade license number, business name, website URL, and contact information.
3. Upload required documents: trade license copy, bank account details (IBAN + bank name), and authorized signatory's ID.
4. Tabby will review your application. Approval typically takes 2–5 business days. You'll receive your Merchant API Key and Secret Key upon approval.

Do not start Step 2 until you have your API credentials. The app won't function without them.

Step 2: Install the Tabby App from Shopify App Store

1. In your Shopify Admin, go to Apps → App and sales channel settings → Shopify App Store.
2. Search for "Tabby" and select the official Tabby app (published by Tabby).
3. Click Add App and confirm the installation permissions.
4. You'll be redirected to the Tabby app configuration screen within Shopify Admin.

[SCREENSHOT: Shopify App Store showing the official Tabby app listing]

Step 3: Connect Your Tabby Merchant Account

1. In the Tabby app, navigate to Settings → API Credentials.
2. Enter your Public Key and Secret Key from your Tabby merchant portal.
3. Select your primary market: UAE (AED), Saudi Arabia (SAR), or Kuwait (KWD).
4. If your store serves multiple GCC markets, Tabby handles currency conversion automatically based on the billing address at checkout.

One thing developers miss here: Tabby processes orders in the customer's billing currency, not your store's base currency. If your store is set to USD base currency but you're serving AED customers, Tabby will convert and process in AED. Ensure your Shopify markets are configured correctly with the right currency enabled for each region.

Step 4: Configure Payment Settings in Shopify

1. Go to Settings → Payments in Shopify Admin.
2. Under Alternative Payment Methods, you should now see Tabby listed.
3. Enable it and confirm the payment method is active.
4. Set your minimum and maximum order values for Tabby eligibility. This prevents the widget from showing on orders Tabby won't approve.

[SCREENSHOT: Shopify Payments settings showing Tabby enabled as alternative payment method]

Step 5: Add the Tabby Widget to Your Product Pages (Critical Step)

This is where most merchants underperform. Installing the app activates Tabby at checkout. But the conversion lift comes from showing installment amounts on the product page, before the customer even adds to cart.

For Shopify stores using Online Store 2.0 themes:

1. Go to Online Store → Themes → Customize.
2. Navigate to your Product template.
3. Look for "Add block" near your price section.
4. If the Tabby app has registered a block, it will appear in the block options as "Tabby Installment Widget" or similar.
5. Add it directly under your price element.

For stores on older themes (not OS 2.0):

You'll need to manually edit the product.liquid or product-template.liquid file. Add the Tabby snippet just below the price display:

<!-- Tabby PDP Widget -->
<div id="TabbyPromo"></div>
<script>
  TabbyPromo.render({
    selector: '#TabbyPromo',
    currency: '{{ shop.currency }}',
    price: {{ product.selected_or_first_available_variant.price | divided_by: 100.0 }},
    lang: 'en',
    source: 'product'
  });
</script>

Note: Tabby provides their own widget initialization script via their merchant portal. The snippet above is illustrative — use the exact script from your Tabby dashboard, as it will include your public key pre-populated.

Also add the widget to your Cart page using the same logic, with source: 'cart' parameter. Showing the installment amount in the cart reinforces the decision already made on the PDP.

[SCREENSHOT: Product page showing Tabby installment widget under price with "4 payments of AED X" display]

Step 6: Enable Test Mode

Before going live, run at least 3 test transactions to verify the full flow.

1. In your Tabby merchant portal, toggle Test Mode to ON.
2. Use Tabby's sandbox test credentials (provided in the merchant portal documentation).
3. Complete a test purchase on your store: add product → proceed to checkout → select Tabby → complete simulated payment.
4. Verify the order appears in both your Shopify orders dashboard and your Tabby merchant portal.
5. Test a refund flow as well: initiate a refund in Shopify and confirm Tabby processes it correctly.

Once testing is complete, toggle Test Mode OFF before your store goes live.

---

Part 2: Installing Tamara on Shopify

Step 1: Apply for a Tamara Merchant Account

1. Go to tamara.co and navigate to Merchant → Sign Up.
2. Complete the merchant application with your business license, bank details, and website information.
3. Tamara is Sharia-compliant and explicitly positioned as such. If your target market includes consumers for whom this matters, Tamara's branding is a selling point you can leverage in your checkout messaging.
4. Approval timeline: similar to Tabby, typically 3–5 business days.

Step 2: Install the Tamara App from Shopify App Store

1. Search for "Tamara" in the Shopify App Store.
2. Install the official Tamara app. The app is listed as free with no installation fees (MDR applies per transaction as negotiated in your merchant agreement).
3. Confirm installation permissions.

Step 3: Configure Tamara Credentials

1. In the Tamara app settings, enter your Merchant Token from the Tamara merchant portal.
2. Select your markets: UAE, Saudi Arabia, Kuwait, or Bahrain.
3. Configure your installment options: Tamara offers both 2-part and 4-part payment splits. Enable both to give customers maximum flexibility.

Step 4: Add Tamara to Checkout

Like Tabby, Tamara appears as an alternative payment method in your Shopify checkout once the app is installed and credentials are entered. Verify it's enabled under Settings → Payments → Alternative Payment Methods.

Step 5: Widget Placement for Tamara

Follow the same widget placement logic as Tabby — product page under price, cart page, and checkout. Tamara provides its own widget script via the merchant portal.

If you're running both Tabby and Tamara simultaneously, stack the widgets cleanly. Don't clutter the PDP with two separate BNPL badges competing for visual space — use a combined display that shows both options if your theme supports it, or prioritize Tabby (higher UAE adoption) and show Tamara at checkout.

Step 6: Test Tamara

Tamara's test mode works via sandbox credentials in their merchant portal. Follow the same test transaction process as Tabby: full purchase → order confirmation → refund flow.

---

The AOV Optimization Layer Most Stores Miss

Installing BNPL and having it show at checkout is the floor, not the ceiling.

The stores that see 20–40% AOV lift from BNPL do the following:

1. PDP microcopy placement. "Or 4 payments of AED X with Tabby" placed directly under the price — not below the add-to-cart button, not in a footer FAQ. Under the price.

2. Cart page reinforcement. When a customer has AED 800 in their cart and sees "4 payments of AED 200" in the cart summary, the mental model shifts from "spending AED 800" to "spending AED 200 today." This is the psychological lever.

3. Homepage hero messaging. A one-line callout: "Shop now. Pay in 4 interest-free installments with Tabby." Simple, high-visibility. Especially effective for first-time visitors who don't know BNPL is available.

4. Arabic localization of widgets. If any portion of your traffic is Arabic-speaking, ensure the Tabby/Tamara widgets are configured to display in Arabic. The lift from Arabic mobile users is disproportionate to effort — both Tabby and Tamara support Arabic widget language settings.

5. GA4 tracking. Set a GA4 custom dimension for payment method to track which payment type correlates with higher AOV and lower return rates. Measure before and after BNPL installation with a 30-day comparison window.

We set all of this up as part of our standard UAE Shopify builds. The payment infrastructure isn't just about accepting money — it's a conversion layer that should be engineered, not installed and forgotten. See how we approach this in our Shopify development work for Dubai brands.

---

Common Issues and Fixes

Issue: Tabby widget not showing on product pages. Most common cause: the widget is only initialized at checkout, not on the PDP. Check whether you've added the PDP widget snippet separately from the app installation. The app activates checkout; the PDP widget requires a separate implementation step.

Issue: "Tabby cannot process this order" error at checkout. Likely causes: (1) order amount is below Tabby's minimum or above maximum, (2) customer billing address is outside UAE/KSA/Kuwait, or (3) your API credentials are in test mode on a live store. Check each in order.

Issue: Currency mismatch error. Tabby processes in AED, SAR, or KWD corresponding to the customer's billing country. If your Shopify market configuration doesn't have the correct currency enabled for the customer's region, you'll see currency mismatch errors. Go to Settings → Markets and verify each market has the correct currency assigned.

Issue: Tamara app not appearing in alternative payment methods. This usually means your merchant token wasn't saved correctly, or the Tamara app doesn't have the required Shopify permissions. Try removing and reinstalling the app, then re-entering your merchant token.

Issue: BNPL widget is slow to load on mobile. Both Tabby and Tamara widgets load asynchronously, but a poorly performing theme can delay widget rendering. Load the widget script with async and defer attributes to prevent it from blocking product page load. On mobile, widget render time directly impacts conversion.

---

What We Typically See in UAT (User Acceptance Testing) Before Launch

Before we hand over any UAE Shopify store with BNPL integrated, our internal checklist covers:

• Tabby widget visible on PDP, positioned under price
• Tamara widget (if installed) visible on PDP
• Cart page shows installment amounts
• Both gateways visible at checkout
• Test transaction completed end-to-end for both Tabby and Tamara
• Refund flow tested and confirmed
• Arabic widget language tested on Arabic language store variant
• Order below minimum threshold — widget correctly hidden
• Order above maximum threshold — widget correctly hidden
• Test mode toggled OFF before handover
• GA4 payment type custom dimension firing correctly

---