| name | saudi-pay |
| description | بوابات الدفع السعودية — ربط بوابات الدفع مثل مويسر وتاب وهايبرباي وتابي وتمارا. استخدم عندما يسأل المستخدم عن قبول المدفوعات أو بوابات الدفع في السعودية. |
| version | 1.0.0 |
| author | Mousa Abu Mazin |
| license | MIT |
| platforms | ["linux","macos"] |
| prerequisites | {"commands":["curl"],"env_vars":["MOYASAR_API_KEY","TAP_SECRET_KEY","HYPERPAY_TOKEN","PAYTABS_SERVER_KEY","PAYTABS_PROFILE_ID","TABBY_API_KEY","TAMARA_TOKEN"]} |
| metadata | {"hermes":{"tags":["arabic","saudi-pay"]}} |
بوابات الدفع السعودية
تنبيه: استخدم بيانات اختبار فقط. لا تستخدم هويات وطنية حقيقية أو توكنات دفع حية أثناء التجربة. استخدم بيئة الاختبار (sandbox) دائماً. احذف السجلات بعد الانتهاء.
دليل شامل لربط بوابات الدفع المتاحة في المملكة العربية السعودية.
نظرة عامة
| البوابة | النوع | عمولة مدى | عمولة فيزا/ماستر | الموقع |
|---|
| مويسر (Moyasar) | بوابة دفع | 1.5% | 2.2% | moyasar.com |
| تاب (Tap) | بوابة دفع | 1.5% | 2% | tap.company |
| هايبرباي (HyperPay) | بوابة دفع | حسب الاتفاق | حسب الاتفاق | hyperpay.com |
| بايتابز (PayTabs) | بوابة دفع | حسب الاتفاق | حسب الاتفاق | paytabs.sa |
| تابي (Tabby) | اشترِ الآن ادفع لاحقاً | — | — | tabby.ai |
| تمارا (Tamara) | اشترِ الآن ادفع لاحقاً | — | — | tamara.co |
| STC Pay | محفظة رقمية | عبر الشريك | عبر الشريك | stcpay.com.sa |
مويسر (Moyasar)
الإعداد
- سجّل في: https://moyasar.com
- احصل على مفتاح API من لوحة التحكم
- اضبط المتغير:
export MOYASAR_API_KEY=sk_test_...
إنشاء عملية دفع
curl -s -X POST "https://api.moyasar.com/v1/payments" \
-u "$MOYASAR_API_KEY:" \
-d "amount=10000" \
-d "currency=SAR" \
-d "description=طلب رقم 123" \
-d "source[type]=creditcard" \
-d "source[name]=اسم حامل البطاقة" \
-d "source[number]=4111111111111111" \
-d "source[month]=12" \
-d "source[year]=2027" \
-d "source[cvc]=123" \
-d "callback_url=https://example.com/callback"
المبلغ بالهللات (10000 = 100 ريال).
استعلام عن عملية دفع
curl -s "https://api.moyasar.com/v1/payments/PAYMENT_ID" \
-u "$MOYASAR_API_KEY:"
تاب (Tap Payments)
الإعداد
- سجّل في: https://developers.tap.company
- احصل على Bearer token
- اضبط المتغير:
export TAP_SECRET_KEY=sk_test_...
إنشاء عملية دفع
curl -s -X POST "https://api.tap.company/v2/charges" \
-H "Authorization: Bearer $TAP_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 100,
"currency": "SAR",
"customer_initiated": true,
"threeDSecure": true,
"save_card": false,
"description": "طلب رقم 123",
"receipt": {"email": true, "sms": true},
"customer": {
"first_name": "محمد",
"email": "test@example.com"
},
"source": {"id": "src_all"},
"redirect": {"url": "https://example.com/redirect"}
}'
هايبرباي (HyperPay)
الإعداد
- سجّل في: https://hyperpay.com
- احصل على Bearer token من بيئة الاختبار
- اضبط المتغير:
export HYPERPAY_TOKEN=OGE...
إنشاء جلسة دفع (Checkout)
curl -s -X POST "https://eu-test.oppwa.com/v1/checkouts" \
-H "Authorization: Bearer $HYPERPAY_TOKEN" \
-d "entityId=YOUR_ENTITY_ID" \
-d "amount=100.00" \
-d "currency=SAR" \
-d "paymentType=DB" \
-d "merchantTransactionId=order_123"
استعلام عن حالة الدفع
curl -s "https://eu-test.oppwa.com/v1/checkouts/CHECKOUT_ID/payment?entityId=YOUR_ENTITY_ID" \
-H "Authorization: Bearer $HYPERPAY_TOKEN"
بايتابز (PayTabs)
الإعداد
- سجّل في: https://merchant.paytabs.sa
- احصل على Server Key و Profile ID
- اضبط المتغيرات:
export PAYTABS_SERVER_KEY=your_server_key
export PAYTABS_PROFILE_ID=your_profile_id
إنشاء صفحة دفع
curl -s -X POST "https://secure.paytabs.sa/payment/request" \
-H "Authorization: $PAYTABS_SERVER_KEY" \
-H "Content-Type: application/json" \
-d '{
"profile_id": "'$PAYTABS_PROFILE_ID'",
"tran_type": "sale",
"tran_class": "ecom",
"cart_id": "order_123",
"cart_description": "طلب رقم 123",
"cart_currency": "SAR",
"cart_amount": 100.00,
"callback": "https://example.com/callback",
"return": "https://example.com/return"
}'
تابي (Tabby) — اشترِ الآن ادفع لاحقاً
الإعداد
- سجّل في: https://tabby.ai/business
- احصل على مفتاح API
- اضبط المتغير:
export TABBY_API_KEY=pk_test_...
إنشاء جلسة Checkout
curl -s -X POST "https://api.tabby.sa/api/v2/checkout" \
-H "Authorization: Bearer $TABBY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"payment": {
"amount": "100.00",
"currency": "SAR",
"buyer": {
"phone": "+966500000000",
"email": "test@example.com",
"name": "محمد أحمد"
},
"order": {
"reference_id": "order_123",
"items": [{
"title": "منتج تجريبي",
"quantity": 1,
"unit_price": "100.00",
"category": "electronics"
}]
}
},
"lang": "ar",
"merchant_code": "YOUR_MERCHANT_CODE",
"merchant_urls": {
"success": "https://example.com/success",
"cancel": "https://example.com/cancel",
"failure": "https://example.com/failure"
}
}'
تمارا (Tamara) — اشترِ الآن ادفع لاحقاً
الإعداد
- سجّل في: https://tamara.co/business
- احصل على Bearer token
- اضبط المتغير:
export TAMARA_TOKEN=your_token
إنشاء جلسة Checkout
curl -s -X POST "https://api.tamara.co/checkout" \
-H "Authorization: Bearer $TAMARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"order_reference_id": "order_123",
"total_amount": {"amount": 100, "currency": "SAR"},
"description": "طلب رقم 123",
"country_code": "SA",
"payment_type": "PAY_BY_INSTALMENTS",
"instalments": 3,
"locale": "ar_SA",
"items": [{
"name": "منتج تجريبي",
"quantity": 1,
"unit_price": {"amount": 100, "currency": "SAR"},
"total_amount": {"amount": 100, "currency": "SAR"}
}],
"consumer": {
"first_name": "محمد",
"last_name": "أحمد",
"phone_number": "+966500000000",
"email": "test@example.com"
},
"merchant_url": {
"success": "https://example.com/success",
"failure": "https://example.com/failure",
"cancel": "https://example.com/cancel",
"notification": "https://example.com/webhook"
}
}'
STC Pay
الدفع عبر STC Pay يتم من خلال بوابات الشراكة (مويسر أو تاب):
عبر مويسر
curl -s -X POST "https://api.moyasar.com/v1/payments" \
-u "$MOYASAR_API_KEY:" \
-d "amount=10000" \
-d "currency=SAR" \
-d "description=طلب رقم 123" \
-d "source[type]=stcpay" \
-d "source[mobile]=0500000000" \
-d "callback_url=https://example.com/callback"
عبر تاب
curl -s -X POST "https://api.tap.company/v2/charges" \
-H "Authorization: Bearer $TAP_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 100,
"currency": "SAR",
"source": {"id": "src_sa.stcpay"},
"redirect": {"url": "https://example.com/redirect"}
}'
عرض النتيجة
💳 عملية دفع:
- البوابة: [اسم البوابة]
- المبلغ: [المبلغ] ريال
- الحالة: [ناجحة/معلّقة/مرفوضة]
- رقم العملية: [ID]
- وسيلة الدفع: [مدى/فيزا/STC Pay/تابي/تمارا]
متى تستخدم
- المستخدم يسأل عن قبول المدفوعات في السعودية
- يريد ربط بوابة دفع في تطبيقه أو متجره
- يسأل عن أفضل بوابة دفع سعودية
- يريد دمج مدى أو STC Pay
- يسأل عن حلول "اشترِ الآن ادفع لاحقاً"
- يسأل "كيف أقبل الدفع الإلكتروني؟"
تنبيه
- استخدم مفاتيح الاختبار (test keys) أولاً
- المبالغ في مويسر بالهللات (اضرب × 100)
- تأكد من دعم 3D Secure لجميع البطاقات
- تابي وتمارا يتطلبان حد أدنى/أقصى للمبلغ
المراجع