Madfu with Wameed POS: Saudi instalments at your till, from a QR on the customer’s phone
Wameed POS offers Madfu at your tills. The customer scans a QR code and completes the Madfu checkout on their phone, and Madfu settles the amount to you. Wameed signs in to Madfu with your merchant credentials and confirms each payment before the sale completes. Professional and above.
3 min read
Wameed POS connects to Madfu, a Saudi instalments provider, so customers can pay in instalmentsat your till: they scan a QR code, complete Madfu’s checkout on their phone, andMadfu settles the amount to you; Wameed confirms each payment with Madfu’s order status before the receipt prints. Professional and above; about 10 minutes once Madfu has activated your account.Reviewed November 2026.
What the Madfu integration does
- Instalments for customers in Saudi Arabia;Madfu settles the purchase amount to you.
- Wameedsigns in to Madfu with your merchant credentials, which checks all five values at connection.
- Payment confirmed with Madfu’s order status before the receipt prints.
- Returns are sent to Madfu asrefund requests; Madfu completes or rejects them and Wameed follows up.
What you need
- Anactivated Madfu merchant account and a merchant-level user of the Madfu merchant portal.
- TheAPI key,app code andauthorization (Basic) value Madfu provided, plus thee-mail and password of your Madfu merchant user — five values in all.
Set up in 4 steps
- If you are not a Madfu merchant, apply through Madfu’s website (Join as a Partner); after the contract is signed Madfu activates your account.
- Collect the API key, app code and authorization value Madfu provides when it sets up your merchant account; for testing, ask for a separate staging set.
- In Wameed chooseSandbox for the staging set orProduction for the live set, paste all five values and select Connect; Wameed signs in to Madfu straight away.
- Optional: ask Madfu support to activate theOrder Status Webhook and give them the address under “Webhook details”; it makes confirmation faster.
What to know — and what it does not do
- Every payment needs thecustomer’s Saudi mobile number (05XXXXXXXX); the till asks if the sale has no customer with one.
- Madfudoes not publish its smallest and largest basket in its API documentation: ask Madfu for yours, then enter the limits in the Installments settings.
- The customer chooses how to pay on Madfu’s own page, so the till offers no plan to pick.
- The webhook isoptional; the till stops waiting after30 minutes and cancels the link at Madfu.
- A return is sent as a refund requestwith the refund fee Madfu’s own calculator gives; voiding a sale refunds it in full the same way.
- Instalments are a till tender, not a storefront option.
Where it fits in Wameed
All branches of one Madfu merchant account use the same API key, app code and authorization value: connect the first branch and copy the connection (the login is copied too). If you want each branch to appear separately in the Madfu portal, ask Madfu for a cashier user per branch. SeeTabby,Tamara andMisPay for the other providers; Wameed is thebest POS for instalments.
More answers
Best POS for instalments ·All integrations ·BNPL at checkout
Frequently asked questions
What do I need to connect Madfu?
Five values from Madfu: an API key, an app code, an authorization value, and your merchant user’s e-mail and password.
What is Madfu’s basket range?
Madfu does not publish it; ask Madfu and enter the limits in the Installments settings.
How are returns handled?
As refund requests to Madfu, with its refund fee; Madfu completes or rejects them and Wameed follows up.
Which plans include Madfu?
Professional and above.
- #مدفوع
- #تقسيط سعودي
- #تقسيط عند الكاشير
- #دفع آجل
- #Madfu integration
- #Madfu Wameed POS
- #Saudi instalments provider
- #BNPL cashier
Share this article
Ask about your own shop
Thirty minutes on your products, your tax setup and your hardware — not a slide deck.
Keep reading
4 min read
Wameed Partner API: connect your own software to your store with API keys and signed webhooks
Give your developers, ERP or online store secure access to a branch’s catalogue, orders, stock, customers and reports through the Wameed Partner API, and push events — new orders, stock changes, ZATCA results — to your systems with signed webhooks. A key per integration, each with only the permissions it needs.
4 min read
ZATCA (Fatoora) with Wameed POS: Phase 2 e-invoicing for every sale, onboarded with a one-time password
Wameed POS is a Phase 2 e-invoicing solution. Every sale is signed with this branch’s cryptographic stamp, carries the ZATCA QR code and goes to ZATCA through Fatoora: simplified (B2C) invoices are reported within 24 hours, standard (B2B) invoices are cleared before issue.
4 min read
WhatsApp Business with Wameed POS: talk to your customers on WhatsApp from your own business number
Connect your own WhatsApp Business number through Meta’s Embedded Signup. Customer messages arrive in Wameed POS, order and booking updates go out from your number, and you choose which branches each number serves. Meta bills WhatsApp message fees to your own Meta account; Wameed adds no markup.

