WooCommerce Development

MyFatoorah for WooCommerce: KNET, mada and Apple Pay Setup Guide

Updated October 30, 2026 7 min read
MyFatoorah for WooCommerce: KNET, mada and Apple Pay Setup Guide

MyFatoorah is a payment service provider for the Gulf, and its official WooCommerce plugin lets one account offer KNET, mada, Benefit, Visa and Mastercard, Apple Pay, STC Pay and several other local methods. You install a single plugin, enter an API token, and MyFatoorah shows the methods that are enabled on your account.

The setup is short, and the traps are in the details: your account manager has to activate the account and the gateways you want, the plugin’s own requirements conflict between the docs and the plugin directory, and orders can go missing without the webhook. This guide covers the MyFatoorah WooCommerce plugin from account to go-live.

Written from MyFatoorah’s official documentation and the WordPress.org plugin listing as read on 30 October 2026. Check the current docs before you go live, because versions and gateway availability change.

What does the MyFatoorah WooCommerce plugin cover?

The plugin listing names these gateways: KNET, Visa and Mastercard, mada, Benefit, Qatar debit cards, UAE debit cards, AMEX, Apple Pay, KFast, STC Pay, Mezza, Orange Cash and Oman Net. Which of them you can actually use depends on your country and on what MyFatoorah enables for your account.

Payment method Market it serves
KNET Kuwait
mada Saudi Arabia
STC Pay Saudi Arabia
Benefit Bahrain
Oman Net Oman
Visa, Mastercard, AMEX, Apple Pay Cross-border and regional cards and wallets

The plugin supports off-site (redirect) payment and on-site (embedded) payment. It can also create shipments with DHL and Aramex, but only after your account manager activates shipping on your account.

What do you need before you install it?

Create an account in the MyFatoorah portal, then contact MyFatoorah so an account manager activates it. Ask for the exact gateways you want, for example KNET for Kuwait or mada for Saudi Arabia, because the plugin only shows what your account has enabled.

The documentation and the plugin directory disagree on technical requirements, so check both:

Source WordPress / WooCommerce PHP
MyFatoorah docs page WooCommerce 3.0.9 up to the latest version, plus SSL 5.6 to 7.4
WordPress.org listing (version 2.2.11) WordPress 6.0 or higher 7.4 or higher

The docs range stops at PHP 7.4, which is old. The listing says 7.4 or higher. Test on a staging copy that runs your real PHP version before you touch the live store. The listing shows more than 2,000 active installs and a 4.3 rating from three reviews, so it is widely used but not heavily reviewed.

How do you install and connect the plugin?

  1. Install and configure WooCommerce first, and make sure the site runs over HTTPS.
  2. Go to Plugins, Add New, search for MyFatoorah, then install and activate the plugin. MyFatoorah’s docs say to use the WordPress.org version and to remove older copies that came from elsewhere.
  3. Open WooCommerce, Settings, Payments and open the MyFatoorah methods.
  4. For testing, switch on test mode and paste the demo token from the MyFatoorah docs.
  5. For live payments, switch test mode off and paste your live token from the portal.

Which MyFatoorah payment option should you choose?

The plugin adds two payment methods, and several display choices inside the Cards method.

Option What the shopper sees When to use it
MyFatoorah – Cards, invoice page (redirect) Redirect to MyFatoorah’s page that lists every enabled gateway with its service charge The simplest setup, and it uses whatever gateways are enabled on your account
MyFatoorah – Cards, list all enabled gateways Gateways listed on your own checkout page, then a redirect to the gateway You want the shopper to pick KNET or mada before leaving your site
Single gateway view Your checkout shows one gateway name and icon instead of the MyFatoorah icon Your account has exactly one gateway enabled
MyFatoorah – Embedded (called OnSite in the FAQ) Payment form inside your checkout Only if your account has a gateway with embedded payment enabled

The docs FAQ tells you to enable only the Cards method when you use it, so do not switch on every MyFatoorah method at once and expect them to stack.

How do you set up the webhook?

The webhook is easy to skip and expensive to forget. It lets MyFatoorah tell your store when a transaction status changes, which recovers orders when the shopper’s connection drops or the callback arrives late. The steps are:

  1. In the MyFatoorah portal, open Integration Settings, then Webhook Settings, and enable the feature.
  2. Enter the endpoint URL in this form, with your own domain: https://yourdomain.com/?wc-api=myfatoorah_webhook
  3. Generate the Webhook Secret Key and copy it.
  4. Select the “Transaction Status Changed” event and save.
  5. In WordPress, open WooCommerce, Settings, Payments, MyFatoorah, paste the key into “Webhook Secret Key” and save.

If your site uses a full-page cache or a security plugin, make sure the ?wc-api= URL is not cached or blocked.

How do you enable Apple Pay with MyFatoorah?

Embedded Apple Pay needs a domain verification file on your server and a plugin switch. MyFatoorah’s WooCommerce page gives these steps:

  1. Create a .well-known folder in your site’s root and put the verification file inside it.
  2. Open https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association and confirm the file loads.
  3. Turn on Apple Pay Embedded in the MyFatoorah plugin settings.

The domain must run over HTTPS, and the docs warn you not to remove the file, because Apple can re-validate the domain. A quick check that the file is publicly reachable and not redirected or blocked:

curl -I https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association

You want a 200 response. Some security plugins and server rules block dot-folders, so check this first if Apple Pay does not appear.

How do you test before going live?

MyFatoorah publishes test cards for the development phase. Not every gateway has them, and the docs say so. What the test cards page covers:

  • KNET: two test cards. One is captured, and the same number with a different expiry is not captured. KNET test cards are not available in all countries.
  • mada: two test cards, and one of them captures.
  • Benefit: five test cards with any expiry and any 6-digit PIN. One is captured, and the others simulate an expired card, a wrong PIN and issuer declines.
  • STC Pay: two test mobile numbers instead of cards, completed with the test OTP in the docs.
  • Apple Pay: no cards listed. Use Apple’s sandbox testing instead.

Use any two-part cardholder name, such as “test test”. Then run each case on a real order: a successful payment, a failure, a cancelled payment, an abandoned checkout, a refund, and a status change that arrives through the webhook. Check the order status and the customer email after every one. When everything passes, switch the plugin to your live token and turn test mode off.

What should you check for Gulf stores?

  • Decimals: Kuwaiti, Bahraini and Omani currencies use three decimal places. Set WooCommerce to three decimals and confirm the gateway rounds the same way. The KNET guide for WooCommerce covers Kuwait in detail.
  • Arabic: the hosted payment page should match your checkout language. Read the Arabic RTL checklist for the checkout side.
  • HPOS and block checkout: the plugin listing does not mention High-Performance Order Storage. Its only changelog entry, 2.2.11, aligns the payment flow with the WooCommerce Blocks lifecycle. Test both on staging.
  • Subscriptions: one reviewer on WordPress.org says the plugin does not support recurring payments through WooCommerce Subscriptions. The docs do not address it, so confirm with MyFatoorah before you build a subscription store on it.
  • Choosing a gateway: if you are still comparing providers, start with the payment gateway comparison for the Gulf.

Frequently asked questions

Does MyFatoorah support KNET on WooCommerce?

Yes, the plugin listing names KNET. Your MyFatoorah account must have KNET enabled, which your account manager does, and KNET must be available for your country.

Why does a payment method not show at checkout?

The Cards method uses the gateways enabled on your MyFatoorah account. If KNET or mada is missing, it is usually not enabled there, or the Embedded method is selected without an embedded gateway on the account.

Do I need a separate plugin for each gateway?

No. One plugin covers all the gateways your account has enabled.

Where do I find the webhook URL?

The docs give the format https://yourdomain.com/?wc-api=myfatoorah_webhook. You enter it in the MyFatoorah portal under Webhook Settings, then paste the secret key into the plugin.

Can I take recurring payments with it?

The documentation does not say, and a reviewer reports that WooCommerce Subscriptions is not supported. Ask MyFatoorah in writing before you rely on it.

Offering buy now, pay later as well? See Tamara and Tabby on WooCommerce.

Need help with a Gulf WooCommerce checkout?

If you want a second pair of eyes on a payment setup, a short technical assessment covers checkout, gateway settings, webhooks and order flow. See my WooCommerce developer service for builds and fixes, or 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