MyFatoorah Integration Guide (2026): Payment Gateway, Payment Links & E-Commerce Invoicing for GCC & MENA
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.
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).
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.
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.
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.
Shopify Fee Savings Calculator
See how much Shopify extracts from your revenue each year vs AddQart's 0% fee
50,000USD
Quick select:
Shopify 2% Penalty TaxDeducted from sales
12,000 USD/year
You lose 1,000 USD/month in platform penalties alone
AddQart 0% Platform FeeKeep 100% Profits
0 USD/year
You keep an extra 12,000 USD/year in your bank account
Save 12,000 USD annually. Start free today.
1-Click automated Shopify catalog migration with 0 downtime
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
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.
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.
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).
M. I. Chowdhury
Executive Leadership
Founder & CEO
Founder and CEO of AddQart, pioneering zero-fee e-commerce infrastructure, unified Cloud POS, and autonomous AI commerce across Qatar and the GCC.
The definitive merchant guide to integrating Tap Payments across Kuwait, Saudi Arabia, the UAE, Qatar, Bahrain, and Oman. Learn how to activate native KNET, MADA, NAPS, and BenefitPay, enable frictionless embedded inline checkouts, and eliminate Shopify's 2% penalty with AddQart's 0% platform fee architecture.
Complete merchant walkthrough for AddQart's native PayLater integration. Discover how to configure OAuth credentials, copy webhooks, test live API handshakes, embed 4-split installment widgets, and unlock zero platform transaction fees.
An unvarnished 10-way fee and feature comparison of Qatar's leading payment gateways. See why AddQart Payments wins with wholesale processing from 1.5% (NAPS debit), $0 fixed fees, native Apple Pay, and unified Cloud POS.
