الانتقال إلى المحتوى الرئيسي
POST
curl

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

الجسم

application/json
amount_in_dollars
number
مطلوب

المبلغ المراد تحصيله بالدولار الأمريكي. يجب أن يكون من 50 إلى 20,000. يتلقى الرصيد نفس المبلغ، دون أي خصم أو مكافأة. تُضاف الضريبة تلقائياً عند الدفع بناءً على عنوان الفوترة الخاص بالعميل.

النطاق المطلوب: 50 <= x <= 20000
success_url
string<uri>

رابط URL الذي تعيد صفحة الدفع المستضافة توجيه العميل إليه بعد نجاح الدفع. القيمة الافتراضية حالياً هي https://console.didit.me. مرّر رابط URL صالحاً بشكل صريح؛ فالمضيف الافتراضي غير متاح. ألحق العنصر النائب الحرفي {CHECKOUT_SESSION_ID} إذا كنت تريد أن تستبدل صفحة الدفع المستضافة معرّف الجلسة به.

cancel_url
string<uri>

رابط URL الذي تعيد صفحة الدفع المستضافة توجيه العميل إليه عندما يلغي العميل نافذة الدفع أو يغلقها. القيمة الافتراضية حالياً هي https://console.didit.me. مرّر رابط URL صالحاً بشكل صريح؛ فالمضيف الافتراضي غير متاح.

الاستجابة

تم إنشاء جلسة الدفع المستضافة. أعد توجيه المستخدم إلى checkout_session_url لإتمام الدفع.

checkout_session_id
string
مطلوب

معرّف جلسة الدفع المستضافة (مثل cs_test_a1B2c3...). مفيد للتسوية من جانب الخادم.

checkout_session_url
string<uri>
مطلوب

رابط URL لصفحة دفع مستضافة للاستخدام لمرة واحدة. أعد توجيه العميل إلى هنا لإتمام الدفع.

آخر تعديل في ٧ نوفمبر ٢٠٢٦