Zoho Integration with mada and Saudi Banks: Complete Setup Guide

Connecting Zoho to mada Pay and Saudi banks isn't just convenience - it's how you eliminate reconciliation friction, automate refunds, and give customers the payment experience they expect in 2026.

Why mada Integration Matters

mada is the dominant payment network in Saudi Arabia - more than 75% of card transactions in KSA flow through mada (either as mada-only or co-badged with Visa/Mastercard). For Saudi customers, mada is the default. Tools without it lose conversion at checkout.

How Zoho Connects to mada

Zoho doesn't connect to mada directly - it connects through Saudi-licensed payment gateways that have mada certification:

• HyperPay - widely used, full mada + Apple Pay + Visa/Mastercard
• PayTabs - mada-certified, regional GCC coverage
• Moyasar - Saudi-native, mada-first, growing fast
• Tap Payments - regional, mada-certified
• Checkout.com - global processor with Saudi/mada coverage
• STC Pay - for wallet-based payments

Integration Architecture

The standard flow:

1. Customer initiates payment (in your Zoho Commerce, Zoho Books Customer Portal, or Zoho Subscriptions checkout)
2. Zoho redirects to the gateway with order details
3. Gateway processes via mada (or Apple Pay/Visa/Mastercard as customer chooses)
4. Settlement happens to your Saudi bank account (T+1 or T+2 typical)
5. Webhook notifies Zoho of payment success/failure
6. Zoho updates the invoice/subscription/order status automatically

Saudi Bank Integration for Reconciliation

Beyond payment acceptance, you'll want your bank's daily statements to reconcile automatically in Zoho Books:

Riyad Bank, SNB, SAB, Al Rajhi

These major Saudi banks support file-based bank feeds (MT940, CSV) and some support API-based real-time feeds via partner integrators. Configure in Zoho Books → Banking → Add Bank Account → file import or live feed.

Bank Reconciliation Workflow

• Daily bank statement imported (file or API)
• Zoho Books auto-matches transactions against open invoices, bills, and journal entries
• Unmatched transactions surface for review
• Reconciliation report generated at month-end

Refund Flows for mada Transactions

Refunding a mada transaction requires going back through the same gateway. Configure Zoho to:

1. Initiate refund from Zoho Books credit note or Zoho Subscriptions cancellation
2. Send refund API call to the gateway
3. Gateway processes refund to customer's mada card
4. Webhook confirms refund completion
5. Zoho records the refund and updates the invoice/order

Settlement and Cash Flow

• T+0 / Same-day: rare in Saudi, available for premium tiers with some processors
• T+1: standard for most Saudi gateway-bank combinations
• T+2 to T+3: common for international processors
• Net settlement: some processors net out chargebacks before settling

Recurring Subscriptions with Zoho Subscriptions + mada

For SaaS, gyms, education, and other subscription Saudi businesses:

• Set up subscription plans in Zoho Subscriptions
• Connect to a mada-supporting gateway
• Recurring charges auto-attempt; failures trigger dunning
• Customers manage their cards via the customer portal

Common Mistakes

• Card-only checkout in Saudi - missing mada destroys conversion
• Apple Pay without mada underneath - Apple Pay in Saudi typically routes via mada, but ensure your processor supports both
• Manual bank reconciliation - automate it; it pays for itself in time saved
• Not capturing customer's billing details for VAT - mandatory for B2B Saudi invoices

Frequently Asked Questions

Does Zoho support mada directly?

Zoho integrates via Saudi-certified gateways (HyperPay, PayTabs, Moyasar, Tap, Checkout.com) that support mada. The result is the same - customers pay with mada through your Zoho-powered checkout.

How long does it take to set up mada in Zoho?

1-2 weeks: gateway account, KYC, technical integration, testing.

What does mada processing cost?

Typically 1.5-2.5% per transaction depending on gateway, volume, and contract.

Setting up payments? Talk to Raqmiat about mada + Zoho.