---
name: Saudi Payment Gateways
priority: 1
keywords: payment, دفع, مدفوعات, mada, مدى, stc pay, stcpay, tabby, تابي, tamara, تمارا, hyperpay, moyasar, مويسر, paytabs, checkout link, رابط دفع, خصم, payment gateway, البي ان بي ال, bnpl
---

# Saudi Payment Gateways — One-Stop

## متى تستخدم
أي شيء يخص الدفع: إنشاء رابط دفع، ربط بمتجر، استرداد، استعلام عن معاملة، اختيار بوابة مناسبة لنوع العمل.

## مقارنة سريعة (للسوق السعودي 2026)

| البوابة | للأنسب | الرسوم | البرنامج | تنشيط |
|---|---|---|---|---|
| **Moyasar** | SMB، startups | 2.85% + 1 SAR | Mada/Visa/MC/Apple Pay/STC Pay | سهل، 1-2 أيام |
| **HyperPay** | enterprise | تفاوضي 1.5-2.5% | كل شيء + tokenization | متوسط، أسبوع |
| **PayTabs** | SMB متعدد دول | 2.85% | كل شيء | سهل |
| **Tabby** | BNPL / تقسيط | 6-7% للتاجر، صفر للعميل | متجر/online فقط | متوسط |
| **Tamara** | BNPL منافس Tabby | 6-7% | متجر/online | متوسط |
| **STC Pay** | wallet payments | 0.5-1.5% | sm Pay/QR | سهل |
| **Mada Pay** | في-store native | غالباً 0% للتاجر | POS فقط | عبر البنك |

## Moyasar (الأشهر للـSMB)
Auth: API key (Publishable + Secret). Base: `https://api.moyasar.com/v1`
```bash
# إنشاء invoice/رابط دفع
exec_command "curl -s -X POST -u '$MOYASAR_SECRET:' -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'amount=15000' \
  -d 'currency=SAR' \
  -d 'description=Order #12345' \
  -d 'callback_url=https://yourdomain.com/moyasar-webhook' \
  'https://api.moyasar.com/v1/invoices'"
# الرد فيه url الـcheckout وid الـinvoice — شارك url مع العميل عبر WhatsApp.

# استعلام عن payment
exec_command "curl -s -u '$MOYASAR_SECRET:' \
  'https://api.moyasar.com/v1/payments/$PAYMENT_ID'"

# refund
exec_command "curl -s -X POST -u '$MOYASAR_SECRET:' -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'amount=15000' \
  'https://api.moyasar.com/v1/payments/$PAYMENT_ID/refund'"
```

## HyperPay (للمتاجر الكبيرة + ERP integrations)
Auth: Bearer + Entity ID. Base: `https://test.oppwa.com` (sandbox) أو `https://oppwa.com` (live)
```bash
# Checkout creation
exec_command "curl -s -X POST -H 'Authorization: Bearer $HYPERPAY_TOKEN' \
  -d 'entityId=$HYPERPAY_ENTITY_ID' \
  -d 'amount=150.00' \
  -d 'currency=SAR' \
  -d 'paymentType=DB' \
  'https://oppwa.com/v1/checkouts'"
```

## Tabby (BNPL — قسّط على 4 دفعات)
Auth: API key. Base: `https://api.tabby.ai/api/v2`
```bash
# Pre-scoring قبل ما تعرض على العميل
exec_command "curl -s -X POST -H 'Authorization: Bearer $TABBY_KEY' -H 'Content-Type: application/json' \
  -d '{\"payment\":{\"amount\":\"500.00\",\"currency\":\"SAR\",\"buyer\":{\"phone\":\"+966500000000\",\"email\":\"a@b.com\"},\"order\":{\"reference_id\":\"#12345\"}},\"lang\":\"ar\"}' \
  'https://api.tabby.ai/api/v2/checkout'"

# الـresponse فيه pay_link، شاركه مع العميل.
```

## Tamara (BNPL منافس)
Auth: Bearer. Base: `https://api.tamara.co`
```bash
exec_command "curl -s -X POST -H 'Authorization: Bearer $TAMARA_TOKEN' -H 'Content-Type: application/json' \
  -d '{\"order_reference_id\":\"#12345\",\"total_amount\":{\"amount\":\"500.00\",\"currency\":\"SAR\"},\"consumer\":{\"phone_number\":\"+966500000000\"},\"country_code\":\"SA\",\"locale\":\"ar_SA\"}' \
  'https://api.tamara.co/checkout'"
```

## أنماط شائعة

### "ابعث رابط دفع لطلب #12345"
1. اقرأ تفاصيل الطلب (من Salla/Zid/ERP).
2. استدعِ Moyasar `/invoices` بالمبلغ + description.
3. شارك الـurl عبر `whatsapp_send`:
```
"رابط الدفع لطلبك #12345:
💳 https://moyasar.com/i/abc123
💰 المبلغ: 500 ر.س
صلاحية الرابط: 24 ساعة"
```

### "العميل يبي يقسّط على Tabby"
1. اعرض Tabby pre-score:
```
"احصل على المنتج الحين، ادفع 4 دفعات بدون فوائد:
• اليوم: 125 ر.س
• الشهر القادم: 125 ر.س
• الشهر بعدها: 125 ر.س
• الشهر اللي بعد: 125 ر.س
🔗 [Tabby checkout link]"
```

### "كم بيع الـMoyasar اليوم"
GET `/payments?limit=200&query=created_at>=2026-05-07` → sum على status='paid'.

## القواعد الذهبية
- ❌ **ممنوع** نشر `secret_key` في WhatsApp/dashboard — هذا = اختراق محفظتك.
- ❌ **لا توعد بـrefund فوري** — عادةً 5-7 أيام عمل لـMada.
- ✅ **شغّل webhook** على كل بوابة لتأكيد الـpayment الفعلي قبل أي شيء.
- ✅ **اختبر في sandbox** قبل أي رابط حقيقي.
- ✅ **PDPL compliance**: لا تخزّن CVV أو full card number — البوابات تعطيك token آمن.
