رقم موحد للعملية
يربط اللاعب والمبلغ والعملة وطريقة الدفع ومزود الدفع وسجل المعالجة الكامل.
الوثائق / سيناريو الدفع
كيف يعمل API الدفع
تعرّف على المسار الكامل للدفع: من إنشاء الإيداع وتأكيد الدفع إلى إضافة الأموال والسحب والاسترداد والتسوية المالية.
الإيداع
الإنشاء والإضافة
السحب
التحقق والإرسال
الحالات
تأكيد العمليات
التسوية
الرقابة المالية
مسار الدفع
من الطلب إلى النتيجة النهائية
01
إنشاء عملية
سجل اللاعب والمبلغ والعملة وطريقة الدفع ورقم العملية الفريد.
02
تأكيد الدفع
وجّه اللاعب إلى صفحة الدفع أو اطلب تأكيد البنك أو نفذ الدفع مباشرة.
03
استلام الحالة النهائية
تحقق من استجابة مزود الدفع وأكد النتيجة النهائية للعملية.
04
تحديث الرصيد والسجلات
أضف أو اخصم الأموال مرة واحدة، وسجل العمولة والعملية لأغراض التسوية.
نظرة عامة
تمر كل عملية دفع بمراحل مضبوطة
تمنح المنصة العملية رقمًا خاصًا بها، وتربطها باستجابة مزود الدفع، ولا تغير الحالة المالية إلا بعد نتيجة مؤكدة. يجب ألا ينشئ الطلب المكرر خصمًا أو إضافة ثانية.
حالات واضحة
تمر العملية فقط عبر المراحل المسموحة ولا تغير نتيجة مكتملة دون تصحيح منفصل.
محاسبة مالية منفصلة
حالة الدفع وتغيير الرصيد والعمولة والقيد المحاسبي مترابطة، لكن يتم التحقق منها بشكل منفصل.
سيناريو الإيداع
سيناريو إيداع نموذجي
يبدأ الإيداع بإنشاء عملية داخلية وينتهي بإضافة الأموال مرة واحدة بعد تأكيد مزود الدفع.
01
التحقق من الطلب وإنشاء العملية
تتحقق المنصة من اللاعب وKYC والحدود والعملة والمبلغ وطريقة الدفع، ثم تمنح العملية رقمًا داخليًا.
02
إرسال الدفع إلى المزود
يتلقى المزود المبلغ والعملة وبيانات اللاعب وعنوان العودة وعنوان الإشعارات والبيانات المطلوبة.
03
تأكيد الدفع
يؤكد اللاعب الدفع في صفحة خارجية أو عبر 3-D Secure أو في تطبيق البنك.
04
استلام التأكيد وإضافة الأموال
بعد التحقق من التوقيع والحالة النهائية، تزيد المنصة رصيد اللاعب مرة واحدة وتكمل العملية.
السحب والاسترداد
سحب الأموال والإلغاء والاسترداد
تتطلب العمليات الصادرة التحقق من اللاعب والرصيد المتاح والمخاطر والبيانات المصرفية والاستجابة النهائية من مزود الدفع.
التحقق من اللاعب
KYC والعمر وحالة الحساب والحدود والاستبعاد الذاتي وطرق السحب المسموحة.
التحقق من المخاطر
AML ومؤشرات الاحتيال وشروط الرهان ومصدر الأموال وموافقة المشغل.
حجز المبلغ
يتم حجز المبلغ في الرصيد حتى استلام النتيجة النهائية للسحب.
الإرسال إلى مزود الدفع
يتم إنشاء طلب سحب منفصل برقم فريد وبيانات مستلم مؤكدة.
انتظار النتيجة
تقبل المنصة الحالات الوسيطة ولا تخصم المبلغ مرة أخرى.
الاسترداد
يتم إنشاء الاسترداد كعملية منفصلة مرتبطة بالدفع الأصلي وبمبلغها الخاص.
الإلغاء
لا يمكن الإلغاء إلا قبل المرحلة غير القابلة للتراجع، ولا يحل محل استرداد عملية مكتملة.
التسوية النهائية
يجب أن يعرض تقرير المزود وبيانات السحب والعمولات وتغييرات الرصيد النتيجة نفسها.
حالات العملية
نموذج الحالات الموصى به
توحد الحالات الداخلية الاستجابات المختلفة لمزودي الدفع في نموذج واحد واضح للمنصة.
تم الإنشاء
تم إنشاء العملية داخل المنصة لكنها لم تُرسل أو تُقبل بعد لدى المزود.
يتطلب إجراء
يجب على اللاعب تأكيد الدفع أو إدخال البيانات أو تنفيذ إجراء في البنك.
قيد المعالجة
قبل المزود العملية، لكن النتيجة النهائية لم تُؤكد بعد.
مكتملة
اكتملت العملية بنجاح، وبعد ذلك يتم تغيير الرصيد مرة واحدة.
مرفوضة
انتهت العملية بالرفض مع حفظ السبب ودون خصم أو إضافة متكررة.
غير مؤكدة
النتيجة النهائية للعملية غير معروفة بسبب انقطاع الاتصال أو تأخر الاستجابة أو تعارض البيانات.
لا يجوز اعتبار النتيجة غير المعروفة رفضًا
ربما يكون المزود قد قبل الدفع حتى دون استجابة في الوقت المناسب. اطلب أولًا الحالة الحالية أو انتظر التأكيد، ثم قرر فقط بعد ذلك ما إذا كانت هناك حاجة إلى عملية مكررة.
الموثوقية والتسوية
الحماية من التكرار والتسوية المالية
تتحدد موثوقية API الدفع بالسلوك الآمن عند الطلبات المكررة والتأكيدات المتأخرة والأعطال الجزئية.
الحماية من تكرار العملية
يحصل كل إيداع وسحب واسترداد على رقم فريد.
يعيد الطلب المكرر النتيجة الموجودة ولا ينشئ عملية مالية جديدة.
يتم التحقق من الإشعار المكرر حسب رقم الحدث وحالة الدفع الحالية.
يرتبط تغيير الرصيد برقم الدفع ويُطبق مرة واحدة فقط.
المحاسبة المالية والتسوية
احتفظ بشكل منفصل بالمبلغ والعمولة وصافي المبلغ المضاف والعملة ورقم المزود.
لا تعدل القيد المكتمل بأثر رجعي، بل أنشئ تصحيحًا منفصلًا.
طابق عمليات API وتقارير المزود وتغييرات الرصيد والمدفوعات.
سجل الفرق وسببه والمسؤول عنه ونتيجة التصحيح.
الاختبار
ما يجب التحقق منه قبل الإطلاق
اختبر الدفع الناجح والرفض وفقدان الاتصال والتأكيد المكرر والنتيجة غير المعروفة والاسترداد والتسوية المالية.
إيداع وسحب ناجحان
جميع الحالات الوسيطة والتأكيد وتغيير الرصيد والتقارير النهائية.
رفض العملية
أموال غير كافية أو بيانات غير صحيحة أو تجاوز الحد أو رفض البنك أو فحص المخاطر أو طريقة دفع غير متاحة.
فقدان الاتصال
ينقطع الاتصال بعد إرسال الطلب، ويصل التأكيد لاحقًا أو يتم طلبه بشكل منفصل.
الطلبات المكررة
تصل العملية نفسها أو التأكيد نفسه مرة أخرى بعد اكتمال المعالجة.
الاسترداد والإلغاء
استرداد كامل وجزئي، وإلغاء قبل المعالجة، ومنع إلغاء عملية مكتملة.
التسوية
يتطابق المبلغ والعمولة والحالة النهائية والرصيد وتقرير المزود بعد جميع السيناريوهات.
قائمة تحقق قبل الإطلاق
تُفعّل المدفوعات الفعلية بعد التحقق من الحالات والتأكيدات والحماية من التكرار والرصيد والتقارير المالية.
تُستخدم بيانات وصول وعناوين إشعارات وحسابات مختلفة لبيئتي الاختبار والعمل.
لا تُستخدم عودة المستخدم إلى الموقع كدليل على نجاح الدفع.
يتم التحقق من التوقيع ورقم الحدث قبل تغيير الرصيد.
الإيداع والسحب والاسترداد محمية من التنفيذ المكرر.
يتم الاستعلام عن الحالة غير المعروفة لدى المزود والتحقق منها أثناء التسوية.
تم إعداد إشعارات الأخطاء وتقارير PSP وإجراءات تحليل الفروقات.
هل تحتاج إلى تصميم سيناريو دفع؟
أرسل قائمة PSP وطرق الدفع والعملات والأسواق وقواعد العمل مع الرصيد والحالات. سيساعد APIACE في تنظيم الإيداع والسحب والاسترداد والتأكيد والتسوية المالية.