واجهة الدفع البرمجية

لكل تاجر مفتاحان، في الملف الشخصي ← مفاتيح الواجهة. المفتاح العام (pk_live_…) آمن للاستخدام في موقعك. المفتاح السري (sk_live_…) يجب أن يبقى على خادمك ويُعرض مرة واحدة فقط.

مرّر مفتاحك كرمز Bearer. المفتاح العام يُنشئ المدفوعات فقط، والمفتاح السري يقرأها فقط.

Authorization: Bearer pk_live_...   # create
Authorization: Bearer sk_live_...   # retrieve

استدعِ هذا من موقعك بمفتاحك العام. CORS مفتوح، فيعمل من أي نطاق. الحد: 60 طلبًا في الدقيقة. يُعيد رابط دفع مُستضاف — وجّه المشتري إليه. يُحفظ اسم المشتري وبريده كأحد عملائك.

المحتوى

{
  "amount": 49.90,
  "currency": "AED",
  "description": "Order #1024",
  "name": "Khaled Al Sabah",
  "email": "khaled@example.com"
}

cURL

curl -X POST 'https://api.paysouhoola.com/api/v1/pay' \
  -H 'Authorization: Bearer pk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 49.90,
    "currency": "AED",
    "description": "Order #1024",
    "name": "Khaled Al Sabah",
    "email": "khaled@example.com"
  }'

JavaScript (browser)

const res = await fetch('https://api.paysouhoola.com/api/v1/pay', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + PUBLIC_KEY, // pk_live_...
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    amount: 49.90,
    currency: 'AED',
    description: 'Order #1024',
    name: 'Khaled Al Sabah',
    email: 'khaled@example.com',
  }),
});
const { url } = await res.json();
window.location.href = url; // send the buyer to checkout

الاستجابة

{
  "reference": "cmsck9hj40007a0vqo70bqmie",
  "url": "https://checkout.stripe.com/c/pay/...",
  "status": "ACTIVE",
  "amount": 4990,
  "currency": "AED"
}

تحقّق من حالة الدفع بمفتاحك السري، باستخدام المرجع الذي أعاده الإنشاء.

cURL

curl 'https://api.paysouhoola.com/api/v1/pay/cmsck9hj40007a0vqo70bqmie' \
  -H 'Authorization: Bearer sk_live_...'

الاستجابة

{
  "reference": "cmsck9hj40007a0vqo70bqmie",
  "status": "PAID",
  "paid": true,
  "amount": 4990,
  "currency": "AED",
  "description": "Order #1024",
  "createdAt": "2026-07-21T00:00:00.000Z"
}

• الإنشاء محدود بـ 60 طلبًا في الدقيقة لكل عنوان IP.
• CORS مفتوح على هذه المسارات — استدعِها من المتصفح.
• لا تضع مفتاحك السري في كود الواجهة. إذا تسرّب، جدّده من ملفك الشخصي.
• المبالغ بالوحدات الكبرى (مثل 49.90)، والحد الأدنى 0.5. العملة بصيغة ISO-4217 مثل AED.