حالة الدفع وحالة الطلب مرتبطتان، لكنهما ليستا السجل نفسه
تبلّغ البوابة بما حدث للدفع، بينما يحدد تطبيقك ما يحدث للطلب. لا تنفّذ الطلب من إشعار غير موثّق، ولا تُرجع حالته للخلف بعد حدث أحدث، ولا تعامل استثناء المبلغ كدفع مكتمل دون سياسة صريحة.
لا تُرسل طلبات أو إشعارات ويب هوك أو تحويلات أو مرتجعات أو تعديلات للطلبات إلى OxaPay. تبقى المدخلات داخل المتصفح، وتظل استجابة API الحقيقية المرجع.
تشرح الأداة انتقالات الحالة وإجراءات التاجر المتوقعة؛ لا تُنشئ دفعاً أو تتصل بواجهة أو تتحقق من معاملة فعلية أو تحل محل Payment Information.
كيفية استخدام محاكي حالة الدفع
يساعد هذا المحاكي التجار والمطورين على فهم أثر حدث الدفع في الطلب. اختر سيناريو جاهزاً أو اضبط المبلغ والانتهاء وتأكيدات الشبكة وطريقة الدفع وسلوك الويب هوك. الأداة تعليمية ولا تتحقق من معاملة حقيقية أو تتصل بمنصة OxaPay.
حالة الدفع ليست حالة الطلب
تبلّغ البوابة بحالة الدفع، بينما يقرر المتجر إبقاء الطلب معلقاً أو تسليمه أو مراجعته. ظهور التحويل لا يعني قبوله نهائياً. يجب ألا يبدأ التسليم غير القابل للإلغاء إلا بعد حالة نهائية متحقَّق منها ومسموح بها. ولا يجوز أن يؤدي الويب هوك المكرر أو المتأخر إلى تسليم الطلب مرة أخرى.
نمذجة النقص وتوقيت الدفع
يُحسب النقص المقبول من المبلغ المطلوب ونسبة السماح المحددة. النقص الكبير والتحويل المتأخر والحالات غير المعتادة تحتاج إلى سياسة تاجر واضحة لا إلى تسليم تلقائي. تتطلب إيداعات العنوان الثابت ربطاً مستقلاً بالعميل والمعاملة. الصفر في تأكيدات الشبكة لا يعادل الحالة النهائية لدى البوابة.
تسليم الويب هوك والاستعادة
تشمل الأمثلة الأحداث المكررة وتوقيع HMAC غير الصحيح والترتيب غير السليم وفشل الإرسال وإعادة المحاولة. على المعالج التحقق من توقيع الطلب الأصلي وربط مرجع الطلب وتنفيذ تغييرات قابلة للتكرار بأمان ومراجعة الحالات المشكوك فيها بواسطة Payment Information أو Payment History. بيانات JSON المعروضة افتراضية.
حدود هذا النموذج
كل أرقام الطلبات والتجزئات والأوقات والبيانات افتراضية. قد تتغير حالات OxaPay وحدودها وإعادة المحاولة؛ راجع الوثائق الرسمية الحالية قبل العمل الإنتاجي. لا ترسل الأداة أموالاً أو مرتجعات أو ويب هوك فعلياً ولا تطلب مفاتيح خاصة.
حالات دفع OxaPay الموثقة
يُحسب النقص المقبول من المبلغ المطلوب ونسبة السماح المحددة. النقص الكبير والتحويل المتأخر والحالات غير المعتادة تحتاج إلى سياسة تاجر واضحة لا إلى تسليم تلقائي. تتطلب إيداعات العنوان الثابت ربطاً مستقلاً بالعميل والمعاملة. الصفر في تأكيدات الشبكة لا يعادل الحالة النهائية لدى البوابة.
new- أُنشئت الفاتورة ولم تُختر عملة الدفع.
waiting- اختيرت عملة الدفع وننتظر التحويل.
paying- تجري معالجة محاولة الدفع أو المعاملة.
paid- دُفعت الفاتورة بالكامل.
manual_accept- قبل التاجر الفاتورة يدوياً.
underpaid- لم تحقق الدفعة الجزئية مبلغ الفاتورة المطلوب.
refunding- بدأت عملية استرداد.
refunded- تم رد المبلغ.
expired- انتهت مدة الفاتورة دون سداد مقبول.
وثائق OxaPay الحالية
راجع جدول الحالات ومعلمات الفاتورة والبحث عن الدفع وتكامل الويب هوك.