ربط خطافات الويب الخاصة بحالة DLR مع أرصدة الدفع المسبق المحتجزة

ربط خطافات الويب الخاصة بحالة DLR مع أرصدة الدفع المسبق المحتجزة.

فهم آلية احتجاز الدفع المسبق

في نظام IOSOR، يؤدي كل طلب رسالة نصية صادرة إلى إجراء فحص فوري لدفتر الأستاذ (Just-In-Time). عند بدء الطلب، يقوم النظام بوضع احتجاز مؤقت على رصيد الحساب لضمان وجود أموال كافية لتسليم الرسالة. هذا الاحتجاز ليس خصماً نهائياً، بل هو حجز لرأس المال. تتم التسوية النهائية فقط عند استلام حالة DLR (إيصال التسليم) من الشبكة، مما يضمن أن دفتر أستاذك المالي يعكس بدقة الاستهلاك الفعلي لرصيد الرسائل.

دورة حياة رد اتصال DLR

بمجرد إرسال الرسالة، تعيد الشبكة حالة DLR. تتلقى نقطة نهاية خطاف الويب الخاصة بك هذه الحمولة، والتي تحتوي على معرف الرسالة الفريد ورمز الحالة النهائي. يقوم محرك IOSOR بربط هذا المعرف بسجل المعاملة الأصلي. إذا كانت الحالة تشير إلى تسليم ناجح، يقوم النظام بتحويل المبلغ المحتجز إلى خصم دائم. إذا كانت الحالة تشير إلى فشل، يتم تحرير الاحتجاز وإعادته إلى رصيدك المتاح، مما يضمن أنك تدفع فقط مقابل المحاولات الناجحة.

إدارة مطابقة دفتر الأستاذ

تتم المطابقة تلقائياً، ولكن يجب على المطورين مراقبة زمن الوصول بين الإرسال ووصول DLR. إذا تأخر DLR، يظل الاحتجاز نشطاً، مما قد يقلل مؤقتاً من رصيدك المتاح. بالنسبة للحسابات التي تحافظ على حد أدنى للدفع المسبق قدره USD 20، يعد هذا أمراً بالغ الأهمية لمنع انقطاع الخدمة. إذا تجاوز حجم عملك الشهري USD 1,000/شهر، يقوم نظامنا بتفعيل مراجعة خفيفة لتعديل حدود الائتمان الخاصة بك وضمان تدفق سلس لحركة المرور عالية التردد.

التعامل مع الحالات الاستثنائية والمهلات

لا تتلقى جميع الرسائل DLR ضمن النافذة المتوقعة. إذا فشلت الشبكة في تقديم تحديث للحالة، يستخدم نظام IOSOR وظيفة تنظيف تقوم بتحرير الاحتجازات القديمة بعد فترة TTL (وقت العيش) محددة. هذا يمنع الاحتجازات 'الوهمية' من التأثير على سيولتك. تأكد دائماً من أن معالج خطاف الويب الخاص بك يقر باستلام DLR في غضون 500 مللي ثانية للحفاظ على المزامنة بين دفتر أستاذنا وسجلاتك المحاسبية الداخلية.

موارد التكامل الأساسية

لضمان أن يكون تنفيذك قوياً ويتبع أفضل الممارسات للنزاهة المالية، راجع هذه الأدلة:

• ترتيب الأحداث مقابل ترحيل دفتر الأستاذ
• يجب ألا يؤدي خط الويب هوك المكرر إلى إنشاء خصم ثانٍ
• اللادورية وإعادة المحاولة والمال

ابدأ مع IOSOR

لإنهاء عملية التكامل، توجه إلى لوحة تحكم IOSOR وانتقل إلى إعدادات Webhook لتكوين نقطة نهاية تسوية دفتر الحسابات. تأكد من أن المستمع لديك جاهز لمعالجة حمولة dlr.status وربطها مباشرة بمعرف حجز المعاملة المقابل. سيضمن اختبار هذا الارتباط في بيئة Sandbox تحرير الأموال المحجوزة أو خصمها فورًا دون أي انحراف في دفتر الحسابات.

خلاصة IOSOR

أوضح هذا الدليل كيفية سد الفجوة بأمان بين تسليم الرسائل في الوقت الفعلي ودقة دفتر الحسابات المالي. من خلال ربط عمليات استدعاء DLR الواردة بحجوزات الدفع المسبق النشطة، فإنك تمنع تجميد رأس المال وتضمن أن يعكس رصيدك المتاح حالات التسليم الفعلية بدلاً من افتراضات الحالة الأسوأ.

احرص على تصميم معالج الـ webhook الخاص بك ليكون متطابقًا تمامًا (idempotent)، مما يضمن عدم تسبب رسائل DLR المكررة في تعديلات متعددة على دفتر الحسابات. لا تعتمد فقط على عمليات الاستدعاء الفورية؛ قم دائمًا بتنفيذ آلية TTL احتياطية لتحرير الحجوزات القديمة عندما يفشل المشغل في إرجاع إيصال التسليم.