Skip to content
QuickshipTechnologies

AppsKSA6 min read

In App Payments Saudi: mada, Apple Pay and STC Pay Guide

In app payments Saudi guide: how mada, Apple Pay and STC Pay work, what SAMA expects, and a checklist to plan checkout for your KSA mobile app.

By · Published

Looking for the software itself? See our app development company Dubai.

In app payments Saudi customers expect start with mada, then Apple Pay and STC Pay. If your app sells goods or services in Saudi Arabia, your checkout should take these three through a gateway licensed by the Saudi Central Bank (SAMA). Cards from abroad and cash on delivery can sit alongside them.

This post explains what each method is, how to choose a gateway, and what to plan before your developers start building.

Which payment methods do Saudi app users expect?

Saudi users expect to pay with mada first, and then with a wallet or phone-based option such as Apple Pay or STC Pay. The Saudi national portal's e-payment page names mada, STC Pay, mada Pay and Apple Pay among the channels it lists.

Here is how they differ for you as the app owner.

Method What it is What to know when building
mada National payment system owned by SAMA Online use runs through 3D Secure. Must be activated on your merchant account.
Apple Pay Phone wallet for cards Supported by gateways such as Tap. Check your gateway for mada card support.
STC Pay Digital wallet Listed on the national portal as a wallet. Confirm your gateway supports it.
mada Pay Stores bank cards on an Android phone SAMA lists it for paying in stores or online. Ask your gateway what it covers.
Visa, Mastercard, Amex International cards Standard at gateway level. Useful for expats and visitors.

I'm not saying you need every row on day one. Start with mada, Apple Pay and one wallet, then add more once you see what customers use.

How do in app payments work in Saudi Arabia?

The customer picks a method in your app, your gateway sends the request to the right network, and the issuer approves or declines it. You never need to build that routing yourself.

For mada, SAMA explains that transactions go through a central system, which redirects them to the card issuer. SAMA says this completes the payment within a few seconds. SAMA also says mada supports card use in online payments at e-commerce outlets through the 3D Secure protocol. So your customer will usually see a bank verification step, such as a one-time code, when paying by mada card.

Your app design should expect that step. If the app closes or loses connection during verification, the order can end up half-finished. We cover that below.

Is mada branding mandatory?

Amazon Payment Services, a payment platform, says on its mada documentation page that mada branding on checkout is mandatory. It calls this a legal requirement in KSA enforced by SAMA, and says non-compliance can disrupt payment processing.

That is a platform's statement, not a SAMA rule text. So ask your own gateway for its branding guidelines and follow them. The same page says mada works like Visa or Mastercard at the integration level and must be activated on the merchant account.

How do you choose a payment gateway for a Saudi app?

Choose a gateway that SAMA has licensed, that supports the methods above, and that gives you clear settlement terms in writing. Pricing and payout timing vary by provider, so ask each one directly.

SAMA licenses and oversees payments under Council of Ministers Resolution No. 226 of 2/5/1440 H. In its licensing release, SAMA tells the public to deal only with licensed institutions and says the list is on sama.gov.sa. The Payment Services Provider regulations were issued on 30 January 2020. A SAMA statement reported by SPA on 26 March 2026 repeats the same advice.

Some gateways publish what they support. For example, Moyasar says it holds a direct SAMA licence and supports mada, Visa, Mastercard, Amex, Apple Pay, STC Pay and Samsung Pay. Treat this as an example of what to look for, not a recommendation. Check the claims against the SAMA list and the provider's contract.

Questions to ask every gateway

  • Is your company on SAMA's licensed list, and under what licence?
  • Which of mada, Apple Pay, STC Pay and Samsung Pay do you support in a mobile app, not just on the web?
  • Do you support recurring payments or pre-authorisation on mada, if my service needs them?
  • What card data touches my servers?
  • How and when do payouts settle, and what is the refund process?
  • Do you provide a mobile SDK for iOS and Android?

What should you plan before building? A step-by-step checklist

Plan the payment flow on paper first. Changing it after the app is built costs more.

  1. List what you sell. Physical goods, services, bookings and subscriptions have different needs. Subscriptions need recurring payments. Hotel-style or deposit flows need pre-authorisation.
  2. Pick your methods. Start with mada, Apple Pay and one wallet. Add international cards and, if your customers expect it, cash on delivery.
  3. Shortlist two or three licensed gateways. Check each name on SAMA's list. Ask the questions above.
  4. Open the merchant account and activate mada. Do this early, because activation can take time and varies by provider.
  5. Design the failure paths. What does the user see if 3D Secure times out, the card is declined or the wallet app is missing?
  6. Test with real cards. Use cards from at least two Saudi banks, on both iPhone and Android.
  7. Write down refunds and reconciliation. Decide who approves refunds and how finance matches payouts to orders.

A worked example, clearly hypothetical: say a Riyadh home-services app lets customers book a cleaner. At checkout it offers mada, Apple Pay and STC Pay. The booking is held as "pending" until the gateway confirms payment. If the confirmation never arrives, the app checks the gateway for the real status instead of showing a failed booking to a customer who has actually been charged. That one rule prevents most double-charge complaints.

What about cash on delivery and buy-now-pay-later?

If you sell physical goods, many Saudi shoppers still expect cash on delivery as an option, and some gateways also offer buy-now-pay-later. Tap, for instance, lists Tabby among its supported methods.

Cash on delivery brings its own work. The courier collects the money, and your finance team has to match collections to orders. If you use several couriers, that matching gets messy fast. Decide this before launch, and cap COD to order values you are comfortable with.

What does the Saudi PDPL mean for app payments?

Payment details are personal data under the Saudi PDPL, so your app must handle them with care. The SDAIA guide for controllers and processors says that if you use personal data, you must comply with the law. It lists bank and credit card numbers as personal data. SDAIA's knowledge centre also says the PDPL applies regardless of volume, so a small app is covered too.

In practice:

  • Don't store full card numbers in your own database.
  • Collect card details through your gateway's own screens or SDK.
  • Tell users what data you collect and why, in your privacy notice.
  • Have a process for users who ask to access or delete their data.
  • Don't use payment contact details for marketing unless the customer agreed. For WhatsApp, message only contacts who opted in.

Ask a Saudi lawyer to review your final setup. This post is not legal advice.

Common mistakes with in app payments in Saudi Arabia

  • Launching with Visa and Mastercard only. You miss customers who rely on mada.
  • Hiding the mada logo. Follow your gateway's branding rules.
  • Treating the app screen as the source of truth. Always confirm the final status with the gateway.
  • Skipping the test on both phones. Apple Pay works on iPhone. mada Pay is an Android option. Test each.
  • Forgetting reconciliation. Payouts, refunds and COD collections need a clear match to orders.
  • Choosing a gateway without checking the licence. Look it up on SAMA's list first.

Where does Quickship fit?

Quickship is a software company. We don't process payments or hold your customers' money. A licensed gateway does that. What we can help with is the app around it: screens, order flow, status handling and connecting your gateway's SDK. If you're planning a Saudi app, see our mobile app development service, or custom software if you need back-office tools for orders and reconciliation. Scope and price are on quote.

Frequently asked questions

Do I have to accept mada if my Saudi app only sells to a few customers?

Plan for it anyway. mada is the national card network supervised by SAMA, and many Saudi customers carry a mada card as their main bank card. A checkout that takes only Visa and Mastercard will lose some of those buyers. Your gateway will tell you how to activate mada on your merchant account.

Can customers pay with a mada card through Apple Pay?

Apple Pay is listed on the Saudi national portal as an e-payment app, and gateways such as Tap say they support Apple Pay and mada. Whether a specific card works depends on the issuing bank and your gateway setup. Test with real cards from more than one bank before launch.

Should my app store customers' card numbers?

For most businesses the answer is no. SDAIA's PDPL guide treats bank and credit card numbers as personal data, so storing them adds duties and risk. Let a licensed gateway collect and tokenise card details, and ask it exactly what data reaches your servers.

Is STC Pay a bank card?

No. The Saudi national portal describes STC Pay as a digital wallet. mada Pay, by contrast, stores bank cards on a phone. They are separate options, so your gateway needs to support each one you want to offer.

How do I check that a payment company is licensed in Saudi Arabia?

SAMA tells the public to deal only with licensed institutions and publishes the list on sama.gov.sa. Check the gateway's name there before you sign. Also ask the provider for its licence details in writing.

Sources

  1. SAMA: mada payment system
  2. Saudi National Portal: e-payment channels
  3. SAMA: licensing of payment institutions (news release)
  4. Amazon Payment Services: mada integration docs
  5. Moyasar: about and supported payment methods
  6. SDAIA: Guide to the Saudi PDP Law for controllers and processors

Rules and fees in the UAE and Saudi Arabia change. This guide reflects the sources above on 14 November 2026. Check the official source before acting on it.

App Development

Mobile and web apps built to your requirements.

Get a quote

Related guides

Instant quote