01 / سير العمل
احتفظ بالمرجع التجاري عبر كل حدث
يكون تشغيل التكامل أسهل عندما تشترك سجلات الدفع واللاعب أو الطلب والتسوية في المراجع منذ البداية.
- 01
أنشئ الجلسة
أرسل المبلغ والعملة والمرجع التجاري وسياق العودة المطلوبة باستخدام بنية الطلب الموثقة حاليًا.
- 02
اعرض تجربة الدفع
وجّه العميل إلى واجهة الدفع المهيأة أو مسار الدفع المعاد لتلك الجلسة.
- 03
عالج الأحداث الموثقة
تحقق من أنواع الأحداث والحقول الموصوفة في وثائق API الحالية وعالجها.
- 04
قيّد وطابق
استخدم مرجع الدفع لربط الحدث واللاعب أو الطلب المقصود والمبلغ المقيد وسجل التسوية.
02 / العمليات
خيارات تكامل تؤثر في العمليات
يفعل التكامل المفيد أكثر من فتح واجهة الدفع؛ فهو يحفظ المراجع والحالات ومسارات الإخفاق التي سيحتاج إليها المشغّل بعد الإطلاق.
تصميم المراجع
اختر مراجع ثابتة للاعب أو الطلب أو الفاتورة يمكن العثور عليها في نظام المشغّل وسجل Payfux معًا.
معالجة الأحداث
عالج حقول الأحداث وحالاتها الموثقة فقط، واحتفظ بالمرجع المستلم للتدقيق والمطابقة.
سلوك العودة
تعامل مع عودة العميل بوصفها تنقلًا في الواجهة، لا دليلًا نهائيًا على اكتمال دفعة أو تسوية.
مسار المطابقة
اربط سجلات الدفع والتسوية في أنظمة المشغّل كي يمكن التحقيق في الفروق باستخدام المرجع.
03 / المتطلبات
يُعتد بالوثائق الحالية
تصف الأمثلة التسويقية تسلسل التكامل، لكنها لا تحدد نقاط نهاية بيئة الإنتاج أو الحمولات أو التوقيعات أو إعادة المحاولات أو قيم الحالة أو مستويات الخدمة.
- استخدم فقط أساليب المصادقة وحقول الطلب الواردة في وثائق API الحالية المقدمة لبيئة العميل.
- لا تعتبر عودة المتصفح دليل دفع موثوقًا؛ استخدم حالة الخادم ونموذج الأحداث الموثقين.
- اختبر معالجة الإخفاق والتكرار والتأخير وتغير الحالة مقابل السلوك الموثق للتكامل.
04 / الأسئلة
أسئلة يطرحها المشغّلون
أين توجد مخططات API الحالية لـ Payfux؟
توجد المخططات الحالية ومتطلبات المصادقة وحقول الطلب في وثائق API الخاصة بـ Payfux. أمثلة الشفرة في صفحات المنتج توضيحية ولا تستبدلها.
هل ينبغي لعودة المتصفح أن تضع علامة اكتمال على الدفع؟
لا. عودة العميل هي عملية تنقل. ينبغي للمشغّل استخدام حالة الدفع على الخادم وأدلة الأحداث الموثقة للقيد والمطابقة.
هل تعد Payfux بجدول محدد لإعادة محاولة الأحداث؟
لا تدّعي هذه الصفحة وجود جدول لإعادة المحاولات. نفّذ سلوك الأحداث والاسترداد المبين في وثائق العميل الحالية.
ما المرجع التجاري الذي ينبغي للمشغّل إرساله؟
استخدم مرجع اللاعب أو العميل أو الفاتورة أو الطلب الثابت الذي يتطلبه التكامل الموثق، واحتفظ به في نظام المشغّل.
هل يمكن استخدام سجلات الاختبار والسجلات الفعلية بالتبادل؟
لا. أبقِ بيانات اعتماد البيئات ونقاط النهاية والسجلات والمطابقة منفصلة، واتبع ضوابط البيئة المذكورة في الوثائق.
وثائق المطورين
ابدأ بمخططات الطلبات والأحداث الحالية
استخدم وثائق Payfux لمعرفة سلوك التكامل الدقيق، ثم طابق مراجع الدفع مع أنظمة المشغّل لديك.
اقرأ الوثائق