SareaPay - بوابة المطورين

البدء السريع

ابدأ في 3 خطوات بسيطة

اتبع هذه الخطوات لبدء قبول المدفوعات عبر SareaPay

1

احصل على مفاتيح API

سجل كتاجر واحصل على مفاتيحك من لوحة التحكم

Public Key pk_live_xxxxxxxx

Secret Key sk_live_xxxxxxxx

Merchant Number +966xxxxxxxxx

2

أنشئ طلب الدفع

أرسل طلب POST لإنشاء جلسة دفع جديدة

$response = Http::post('https://alsarea.com/api/v1/create-payment-order', [
    'public_key' => 'YOUR_PUBLIC_KEY',
    'secret_key' => 'YOUR_SECRET_KEY',
    'merchant_number' => 'YOUR_MERCHANT_NUMBER',
    'amount' => 150.00
]);

const response = await fetch('https://alsarea.com/api/v1/create-payment-order', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        public_key: 'YOUR_PUBLIC_KEY',
        secret_key: 'YOUR_SECRET_KEY',
        merchant_number: 'YOUR_MERCHANT_NUMBER',
        amount: 150.00
    })
});

import requests

response = requests.post('https://alsarea.com/api/v1/create-payment-order', json={
    'public_key': 'YOUR_PUBLIC_KEY',
    'secret_key': 'YOUR_SECRET_KEY',
    'merchant_number': 'YOUR_MERCHANT_NUMBER',
    'amount': 150.00
})

3

تحقق من الدفع

تحقق من حالة الدفع بعد إتمام العملية

200 OK

{
  "payment_record": {
    "transaction_id": "SP_1705234567",
    "amount": 150.00,
    "is_paid": 1,
    "status": "completed"
  }
}

API Reference

مرجع واجهة البرمجة

وثائق كاملة لجميع نقاط النهاية المتاحة

POST /api/v1/create-payment-order

إنشاء طلب دفع جديد وإرجاع رابط صفحة الدفع

المعاملات المطلوبة

المعامل	النوع	الوصف
`public_key`	string	المفتاح العام للتاجر
`secret_key`	string	المفتاح السري للتاجر
`merchant_number`	string	رقم جوال التاجر المسجل
`amount`	number	مبلغ الدفع

الاستجابة

{
  "status": "payment_created",
  "redirect_url": "https://alsarea.com/payment/SP_xxxxx",
  "transaction_id": "SP_1705234567",
  "expires_at": "2026-01-14T15:30:00Z"
}

{
  "status": "merchant_not_found",
  "errors": [{
    "code": "INVALID_CREDENTIALS",
    "message": "بيانات التاجر غير صحيحة"
  }]
}

POST /api/v1/payment-verification

التحقق من حالة عملية الدفع

المعاملات المطلوبة

المعامل	النوع	الوصف
`public_key`	string	المفتاح العام للتاجر
`secret_key`	string	المفتاح السري للتاجر
`merchant_number`	string	رقم جوال التاجر المسجل
`transaction_id`	string	معرف المعاملة

الاستجابة

{
  "payment_record": {
    "id": "uuid-here",
    "transaction_id": "SP_1705234567",
    "amount": 150.00,
    "is_paid": 1,
    "callback": "https://your-site.com/callback",
    "created_at": "2026-01-14T12:00:00Z"
  }
}

Base URL

Production https://alsarea.com

Sandbox https://sandbox.alsarea.com

SDK

حزم التطوير الجاهزة

استخدم SDK المناسب للغتك المفضلة

PHP SDK

لتطبيقات Laravel و PHP

composer require sareapay/php-sdk

عرض التوثيق

JavaScript SDK

لـ Node.js و Frontend

npm install sareapay-js

عرض التوثيق

Python SDK

لتطبيقات Django و Flask

pip install sareapay

عرض التوثيق

WordPress Plugin

لـ WooCommerce

تحميل من لوحة التحكم

تحميل الإضافة

Sandbox

بيئة الاختبار التفاعلية

جرب API مباشرة من المتصفح بدون كتابة كود

Request

اتصال حقيقي (Live)

Endpoint

Public Key

Secret Key

Merchant Number

Amount (المبلغ)

Callback URL (اختياري)

تحذير: أنت في وضع الاتصال الحقيقي - سيتم إرسال الطلب فعلياً إلى الخادم

Response

جاهز --ms

// الاستجابة ستظهر هنا بعد إرسال الطلب

{
  "message": "اضغط على 'إرسال الطلب' لتجربة API",
  "tip": "استخدم البيانات الافتراضية للاختبار"
}

أمر cURL

curl -X POST "https://alsarea.com/api/v1/create-payment-order" \
  -H "Content-Type: application/json" \
  -d '{
    "public_key": "I6MGcMQQT1lyiG8v5KzEiK5U5ktoCfPiir5N9RXRIPw3fEuK9j",
    "secret_key": "SyJaPE3ppi5lpdLNYMGz3NCWvLskKLwvvQDznHVC3I6PGhFv0b",
    "merchant_number": "123456789",
    "amount": 250
  }'

بيانات الاختبار

دفع ناجح

رقم الحساب: +966500000001

رمز PIN: 1234

OTP: 123456

رصيد غير كافي

رقم الحساب: +966500000002

رمز PIN: 1234

OTP: 123456

انتهاء الصلاحية

رقم الحساب: +966500000003

انتظر 5 دقائق

Payment Flow

مسار عملية الدفع

فهم كيفية عمل دورة الدفع الكاملة

1. موقع التاجر

العميل يبدأ عملية الشراء

2. إنشاء الطلب

API يُنشئ جلسة دفع

3. صفحة الدفع

العميل يُدخل بياناته

4. التحقق

OTP + PIN

5. الإتمام

Callback + Success

Error Codes

رموز الأخطاء

قائمة بجميع رموز الأخطاء المحتملة وكيفية التعامل معها

الرمز	الحالة	الوصف	الحل
`MERCHANT_NOT_FOUND`	401	التاجر غير موجود	تحقق من صحة بيانات التاجر
`INVALID_CREDENTIALS`	401	بيانات اعتماد غير صحيحة	تأكد من Public Key و Secret Key
`INSUFFICIENT_BALANCE`	400	رصيد العميل غير كافي	أبلغ العميل بشحن رصيده
`PAYMENT_EXPIRED`	400	انتهت صلاحية الدفع	أنشئ طلب دفع جديد
`INVALID_PIN`	401	رمز PIN غير صحيح	العميل يحتاج إعادة إدخال PIN
`INVALID_OTP`	401	رمز OTP غير صحيح	إعادة إرسال OTP جديد
`TRANSACTION_NOT_FOUND`	404	المعاملة غير موجودة	تحقق من Transaction ID

التوثيق الكامل

دليل شامل لجميع الميزات والإعدادات

تصفح التوثيق

الدعم الفني

فريق دعم متخصص على مدار الساعة

تواصل معنا

GitHub

أمثلة وحزم مفتوحة المصدر

عرض المستودعات

مجتمع المطورين

انضم لمجتمع مطوري SareaPay

انضم الآن