كيف تمنع إشعار دفع مكرر من تسليم المنتج مرتين؟

الإجابة العملية

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

خطوات التطبيق

1. تحقق من توقيع الإشعار وفق تعليمات مزود الدفع قبل استخدام محتواه
2. احفظ مرجعًا يمنع تكرار أثر التسليم للعملية المعالجة بالفعل
3. اختبر إعادة الحدث نفسه وتغير ترتيب الأحداث وتأكد من ثبات سجل الطلب

مثال تطبيقي افتراضي

مثال افتراضي للتوضيح، وليس نتيجة عميل حقيقي: متجر رقمي افتراضي يتلقى إشعارًا ناجحًا ثم نسخة أخرى بعد إعادة محاولة المزود. يسجل النظام الحدث الأول ويمنح الوصول مرة واحدة، ثم يتعرف إلى المرجع المكرر دون إنشاء طلب آخر أو إرسال ملفات جديدة. يراجع الفريق السجل ليثبت سبب تجاهل النسخة الثانية بدل إيقاف استقبال الإشعارات بالكامل.

أخطاء تستحق الانتباه

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

كيف تتحقق من التنفيذ؟

• ينفذ الحدث الصحيح أثره مرة واحدة عند إعادة إرساله
• يرفض النظام رسالة لا تجتاز التحقق ولا يغير حالة الطلب بها