--- title: "MyFatoorah Integration Guide (2026): Payment Gateway, Payment Links & E-Commerce Invoicing for GCC & MENA" slug: "myfatoorah-integration-ecommerce-guide" url: "https://www.addqart.com/en/blog/myfatoorah-integration-ecommerce-guide" author: "M. I. Chowdhury" author_full_name: "Murshedul Islam Chowdhury" author_role: "Founder & CEO" author_linkedin: "https://www.linkedin.com/in/murshedic/" category: "GCC Payments & Compliance" published_date: "2026-09-11T16:00:00Z" updated_date: "2026-09-11T16:00:00Z" reading_time_minutes: 15 language: "en" tags: ["MyFatoorah", "MyFatoorah Payment Gateway", "Payment Link", "E-Commerce Invoicing", "Online Store MyFatoorah", "GCC Payments", "KNET Payment", "MADA Gateway", "NAPS Qatar", "Zero Fee E-Commerce"] description: "The definitive merchant guide to integrating MyFatoorah with your online store. Learn how to configure regional API endpoints across Qatar, Saudi Arabia, UAE, Kuwait, Egypt, Bahrain, Jordan, and Oman, generate instant WhatsApp payment links, and eliminate Shopify's 2% penalty with AddQart's 0% platform fee architecture." platform: "AddQart (أدكارت) - The 0% Fee Unified Commerce Platform" --- # MyFatoorah Integration Guide (2026): Payment Gateway, Payment Links & E-Commerce Invoicing for GCC & MENA > **Executive Summary / TL;DR**: - MyFatoorah is the premier payment gateway and invoicing engine across the GCC and MENA, supporting native domestic debit cards (KNET, MADA, NAPS, BenefitPay, Meeza) and international cards. - AddQart features a native, turn-key MyFatoorah integration with zero custom coding required: enter your API Token, select your regional endpoint, and start accepting payments in 60 seconds. - Dedicated regional endpoints prevent cross-border latency and optimize bank approval rates: Qatar (api-qa), Saudi Arabia (api-sa), UAE (api-ae), Egypt (api-eg), and Kuwait/Bahrain/Jordan/Oman (api.myfatoorah.com). - Retailers can generate instant 1-click payment links directly from the AddQart dashboard for WhatsApp, Instagram DM, and telephone sales with automated digital invoice receipts. - Unlike Shopify, which charges an extra 1.0% to 2.0% third-party gateway fee on MyFatoorah orders, AddQart charges strictly 0% platform transaction fees across all subscription plans. - Includes complete cryptographic HMAC SHA-256 webhook signature verification and seamless test sandbox environment switching (apitest.myfatoorah.com). **Key Takeaway**: Enterprise Integration Summary: Integrating MyFatoorah on AddQart enables multi-market e-commerce across 8 Arab economies with localized payment rails (KNET, MADA, NAPS, BenefitPay, Meeza, Fawry). By running your online store on AddQart, you eliminate Shopify's 2% non-Shopify-Payments penalty, preserving $12,000 to $24,000 annually per $1M in transaction volume, while unlocking automated WhatsApp payment links and digital invoicing. --- ## 1. The GCC & MENA Payment Landscape: Why National Debit Rails Dominate Operating a high-converting e-commerce website in the Middle East and North Africa (MENA) requires an understanding of consumer payment psychology. Unlike Western markets where credit cards reign supreme, consumers across the Gulf Cooperation Council (GCC) and North Africa overwhelmingly favor **domestic national debit networks**. In Kuwait, over **85% of online retail purchases** are executed via **KNET**. In Saudi Arabia, **MADA** accounts for more than **70% of digital transactions**. In Qatar, **NAPS (QPay)** is the preferred bank debit rail. In Egypt, government-backed **Meeza** cards and cash-replacement networks like **Fawry** are vital for unlocking mass-market retail adoption. When an online store forces local shoppers through an international card-only checkout that rejects local debit cards or charges foreign transaction markup fees, cart abandonment rates surge above **65%**. **MyFatoorah** directly bridges this divide by consolidating domestic debit rails, regional buy-now-pay-later (BNPL), and global credit cards into a unified, high-availability payment gateway. --- ## 2. What is MyFatoorah? Architecture, Currencies & Settlement Founded in Kuwait and licensed across the GCC and Egypt, **MyFatoorah** is an enterprise-grade fintech gateway and digital invoicing engine designed specifically for regional merchants. ### Core Architectural Features - **Direct Multi-Currency Support**: Natively processes transactions in **KWD, SAR, QAR, AED, BHD, OMR, EGP, JOD, USD, and EUR** without forced currency conversion losses. - **Unified Checkout Window**: Offers an embedded, responsive modal or clean hosted payment redirect that automatically displays the shopper's local payment method. - **Fast Merchant Payouts**: Automated settlement into local commercial bank accounts across all supported territories within 24 to 48 business hours. - **Zero Fixed Infrastructure Costs**: Transparent per-transaction pricing with no monthly lock-in contracts or maintenance overhead. ``` +---------------------------------------------------------------------------------+ | MYFATOORAH PAYMENT ECOSYSTEM ON ADDQART | +---------------------------------------------------------------------------------+ | [ONLINE STORE / CHECKOUT] [WHATSAPP PAYMENT LINK] [CLOUD POS] | | | | | | | +--------------------------------+-----------------------+ | | | | | [ADDQART UNIFIED GATEWAY] | | | | | +--------------------------+--------------------------+ | | | | | | [REGIONAL DOMESTIC DEBIT] [GLOBAL CARDS] | | (KNET, MADA, NAPS, BenefitPay, Meeza) (Visa, MC, AMEX) | | | | | | +--------------------------+--------------------------+ | | | | | [MYFATOORAH SETTLEMENT] | | | | | [MERCHANT DIRECT BANK ACCOUNT (100%)] | +---------------------------------------------------------------------------------+ ``` --- ## 3. The 8 Supported Countries & Dedicated Regional API Endpoints A major engineering flaw of generic e-commerce plugins is routing all Middle Eastern transactions through a single distant server, introducing 800ms+ network latency and triggering international bank security flags. AddQart's native MyFatoorah integration solves this by providing **dedicated, low-latency regional API endpoints** optimized for each market: | Country & Flag | Primary Domestic Debit Rails | Supported Currencies | Dedicated AddQart API Endpoint | | :--- | :--- | :--- | :--- | | **Qatar 🇶🇦** | **NAPS (QPay)**, Apple Pay, Cards | **QAR, USD** | `api-qa.myfatoorah.com` | | **Saudi Arabia 🇸🇦** | **MADA**, Apple Pay, STC Pay | **SAR, USD** | `api-sa.myfatoorah.com` | | **United Arab Emirates 🇦🇪** | Apple Pay, Google Pay, Cards | **AED, USD** | `api-ae.myfatoorah.com` | | **Egypt 🇪🇬** | **Meeza**, Fawry, Cards | **EGP, USD** | `api-eg.myfatoorah.com` | | **Kuwait 🇰🇼** | **KNET**, Apple Pay, Cards | **KWD, USD** | `api.myfatoorah.com` | | **Bahrain 🇧🇭** | **BenefitPay**, Cards | **BHD, USD** | `api.myfatoorah.com` | | **Jordan 🇯🇴** | **CliQ**, Local Cards | **JOD, USD** | `api.myfatoorah.com` | | **Oman 🇴🇲** | **OmanNet**, Cards | **OMR, USD** | `api.myfatoorah.com` | | **Test Environment 🧪** | Virtual Sandbox Cards & Wallets | **Multi-Currency** | `apitest.myfatoorah.com` | By selecting your specific country endpoint, your store connects directly to MyFatoorah's local banking infrastructure, maximizing authorization rates and completing checkouts in under 2 seconds. --- ## 4. Instant Payment Links & WhatsApp E-Commerce Invoicing In conversational markets like the GCC, millions of dollars in sales take place over **WhatsApp, Instagram Direct Messages, and phone consultations**. Forcing a high-intent customer to navigate a complex web cart often kills the deal. ### The 1-Click WhatsApp Payment Link Workflow 1. **Create Order in Dashboard**: The retailer selects products, applies custom discounts, and clicks **"Generate Payment Link"**. 2. **Instant Link Generation**: AddQart automatically communicates with MyFatoorah's `/v2/SendPayment` endpoint to create an encrypted, tokenized payment URL. 3. **Share via WhatsApp / SMS**: With a single click, the merchant sends the link to the customer via WhatsApp: > *"Hello Fatima! Here is your private payment link for your custom Abaya order (QAR 650): https://pay.addqart.com/pay/mf_98421 — Valid for 24 hours."* 4. **Frictionless Customer Checkout**: The customer taps the link on their smartphone, sees an automated itemized invoice, and completes payment in 3 seconds using Apple Pay, KNET, or MADA. 5. **Automated Order Reconciliation**: Once paid, MyFatoorah notifies AddQart via webhook; the order status flips automatically from *Unpaid* to *Paid*, inventory is deducted, and a PDF tax invoice is automatically generated. --- ## 5. The 0% Fee Reality: AddQart vs. Shopify's 2% Penalty Tax When merchants evaluate payment gateways, they often focus solely on the gateway's quoted merchant fee (typically 1.5% to 2.5% + transaction fee). However, on legacy platforms like **Shopify**, there is a massive hidden cost: the **Third-Party Payment Gateway Penalty Tax**. Because Shopify operates its own gateway (Shopify Payments), which is unavailable or heavily restricted in countries like Qatar, Saudi Arabia, Kuwait, and Egypt, Shopify penalizes merchants who connect MyFatoorah with an extra **0.5% to 2.0% fee on every sale**. *[Note: An interactive fee calculator is available on the live page at https://www.addqart.com/en/blog/myfatoorah-integration-ecommerce-guide]* ### The Mathematical Reality: $1,000,000 Annual Online Sales | Platform & Setup | Gateway Processing Fee (MyFatoorah) | Platform Penalty Fee | Annual Platform Drain | Net Merchant Savings on AddQart | | :--- | :--- | :--- | :--- | :--- | | **Shopify Basic ($39/mo)** | ~2.0% to MyFatoorah | **2.0% Shopify Penalty** | **$20,468 / year** | **+$20,468 Saved** | | **Shopify Standard ($105/mo)**| ~2.0% to MyFatoorah | **1.0% Shopify Penalty** | **$11,260 / year** | **+$11,260 Saved** | | **Shopify Advanced ($399/mo)**| ~2.0% to MyFatoorah | **0.6% Shopify Penalty** | **$10,788 / year** | **+$10,788 Saved** | | **AddQart Commerce OS** | ~2.0% to MyFatoorah | **0.0% (Zero Platform Fee)** | **$0 Extra Fees** | **100% Margin Protected** | On AddQart, you pay **strictly 0% platform transaction fees**. Every single riyal, dirham, or dinar you earn belongs 100% to your business. --- ## 6. Step-by-Step Dashboard Setup: The Exact Configuration Flow Connecting MyFatoorah on AddQart requires zero code, zero plugin downloads, and takes less than 60 seconds. ``` [AddQart Merchant Dashboard] -> [Settings] -> [Payments] -> [MyFatoorah] ``` ### Step 1: Access Payment Settings In your AddQart sidebar, navigate to **Settings → Payments**. In the gateway management grid, locate the **MyFatoorah** tile and click on it. ![AddQart Merchant Dashboard — Payment Gateways Overview](https://cdn.addqart.com/files/blog/posts/dashboard/dashboard-payments.webp) ### Step 2: Input Your API Credentials In the MyFatoorah settings panel, enter your credentials: ![AddQart MyFatoorah Gateway Settings Panel](https://cdn.addqart.com/files/blog/posts/dashboard/dashboard-myfatoorah.webp) 1. **API Token / Secret Key (`token`)**: Paste the API token provided in your MyFatoorah merchant portal under `Integration Settings → API Key`. 2. **Webhook Secret Key (Optional - Signature Verification)**: Enter your secret key to enable cryptographic **HMAC SHA-256 verification** on all incoming payment notifications. 3. **Gateway Endpoint / Region**: Select your primary operating market from the regional dropdown. ### Step 3: Select Your Dedicated Country Endpoint Click the **Gateway Endpoint / Region** dropdown to match your operating jurisdiction: ![MyFatoorah Regional API Endpoints Dropdown](https://cdn.addqart.com/files/blog/posts/dashboard/dashboard-myfatoorah-1.webp) - **Qatar**: `Qatar - api-qa.myfatoorah.com` - **Saudi Arabia**: `Saudi Arabia - api-sa.myfatoorah.com` - **United Arab Emirates**: `UAE - api-ae.myfatoorah.com` - **Egypt**: `Egypt - api-eg.myfatoorah.com` - **Kuwait, Bahrain, Jordan, Oman**: `Kuwait, Bahrain, Jordan, Oman - api.myfatoorah.com` - **Sandbox Testing**: `Test (Sandbox) - apitest.myfatoorah.com` ### Step 4: Configure the Webhook Endpoint In the **MyFatoorah Webhook Endpoint URL** box: - Click the **"Copy Webhook URL"** button to copy: `https://api.addqart.com/api/webhooks/myfatoorah` - Paste this URL into your MyFatoorah merchant portal under `Webhook Settings` and select event types: `TransactionsStatusChanged` and `RefundStatusChanged`. ### Step 5: Activate Gateway Toggle the **MyFatoorah Status** switch from *Inactive* to **Active** and click **Save Changes**. Your online store is now fully live and accepting payments across 8 countries! --- ## 7. Omnichannel Checkout Experience: Web, Mobile & Cloud POS Modern retail success requires connecting digital storefronts with brick-and-mortar operations. With AddQart, your MyFatoorah integration functions seamlessly across all customer touchpoints: ### Web & Mobile Storefront - **1-Page Frictionless Checkout**: Shoppers select their preferred domestic rail (KNET, MADA, NAPS, Apple Pay) on a single responsive screen. - **Biometric 1-Tap Pay**: iOS shoppers complete orders in under 3 seconds using Apple Pay with Face ID / Touch ID. ### Physical Cloud POS Integration - Store cashiers can initiate a payment request directly from the **AddQart Cloud POS** register on an iPad or Android tablet. - The POS displays a dynamic QR code on the customer-facing screen, allowing the in-store shopper to scan and pay via MyFatoorah without needing a physical bank card terminal. --- ## 8. Automated Reconciliation, HMAC Webhooks & Order Lifecycle Manual order reconciliation—where store staff manually check bank accounts or screenshot slips before packing orders—is the leading cause of fulfillment delays and inventory errors. ### The Real-Time Asynchronous Webhook Pipeline 1. **Customer Completes Payment**: The shopper approves the transaction on their bank's 3D-Secure screen. 2. **Instant Callback**: MyFatoorah's edge servers send an asynchronous POST request to `https://api.addqart.com/api/webhooks/myfatoorah`. 3. **HMAC Cryptographic Validation**: AddQart inspects the `MyFatoorah-Signature` header against your `webhook_secret` using HMAC-SHA256, mathematically verifying that the notification is authentic. 4. **Order State Update**: - Order status automatically updates to **"Processing / Paid"**. - Warehouse barcode labels and packing slips are automatically generated. - SMS and WhatsApp confirmation receipts are sent to the customer with live courier tracking links. --- ## 9. Tax, E-Invoicing & Regional Compliance (ZATCA & VAT) Selling online across the GCC and Egypt requires rigorous adherence to local fiscal authorities: - **Saudi Arabia (ZATCA Phase 2)**: AddQart automatically generates compliant B2C e-invoices with encoded cryptographic QR codes and sends compliant XML records. - **Qatar (0% Domestic VAT & Tax Exemptions)**: Seamless configuration for registered Qatari SMEs and QSTP tech companies. - **UAE & Bahrain (5%–10% VAT)**: Automated destination-based VAT calculation at checkout with itemized tax summaries. - **Egypt (ETA E-Receipt)**: Formatted digital receipts supporting local tax registration IDs and e-invoicing mandates. --- ## 10. High-Intent Search FAQs: Everything Retailers Ask ### What is MyFatoorah and how does it work with AddQart? MyFatoorah is a leading regional payment gateway and invoicing engine in the Middle East. On AddQart, MyFatoorah integrates natively with zero code, allowing online stores to accept domestic debit cards (KNET, MADA, NAPS, BenefitPay, Meeza), international cards, and generate 1-click WhatsApp payment links. ### Which countries are supported by MyFatoorah on AddQart? MyFatoorah supports 8 key markets: Qatar, Saudi Arabia, the United Arab Emirates, Kuwait, Egypt, Bahrain, Jordan, and Oman. AddQart provides dedicated regional API endpoints for each market to guarantee maximum speed and bank authorization rates. ### How much does it cost to use MyFatoorah on AddQart? AddQart charges **strictly 0% platform transaction fees** on all MyFatoorah orders across all subscription plans. Merchants pay only their standard merchant processing fee directly to MyFatoorah, saving 1.0% to 2.0% compared to Shopify. ### Can I generate payment links to send to customers via WhatsApp? Yes. From your AddQart merchant dashboard, you can generate instant, encrypted 1-click payment links for custom orders or telephone sales and send them directly to customers via WhatsApp or SMS. ### How do I test MyFatoorah before going live? In your AddQart dashboard, check the **"Enable Sandbox/Test Mode"** box and select the `Test (Sandbox) - apitest.myfatoorah.com` endpoint. You can run test orders using MyFatoorah's simulated test cards without charging real funds. ### What currencies can I accept through MyFatoorah? MyFatoorah natively supports QAR, SAR, AED, KWD, BHD, OMR, EGP, JOD, USD, and EUR, allowing merchants to sell across borders without forced foreign exchange conversion penalties. ### Does MyFatoorah support Apple Pay and Google Pay? Yes. MyFatoorah supports native Apple Pay and Google Pay checkouts on supported mobile devices and browsers, allowing customers to complete transactions with biometric authentication in seconds. ### How are payments settled into my bank account? MyFatoorah deposits 100% of your net settled funds directly into your local commercial business bank account on an automated payout cycle (typically every 24 to 48 business hours). --- ## Frequently Asked Questions (FAQ) --- *Published by AddQart Technologies — 0% Transaction Fees, Native Qatar NAPS, Saudi MADA, and Unified Cloud POS.*