يجب ألا يؤدي خط الويب هوك المكرر إلى إنشاء خصم ثانٍ

سيتم إعادة محاولة التسليم مرة واحدة على الأقل. يعتبر الويب هوك المكرر الذي ينشر خصماً ثانياً أو خطاً ثانياً في صندوق الوارد حادثة أموال وتشغيل وليست «إقراراً غير ضار». هذه الصفحة هي مسار الفشل: تظل إعادة المحاولة والتشغيل متماثلة في الأموال المدفوعة مسبقاً وصندوق الوارد — وليست مقالة إرسال الAPI المتماثلة ولا دليل إعادة محاولة الرسائل الواردة.

ذات صلة: بوابة التوقيع ونافذة إعادة التشغيل، عقد الويب هوك قبل الإرسال الأول، صفوف الخصم وحالة التسليم في نفس الدفتر.

IOSOR هي خدمة مدفوعة مسبقاً بعلامة بيضاء. يمكّن مبلغ USD 20 من تمويل دخان الأحداث المكررة على مستهلك واحد؛ وتتسع مراجعة لينة تقارب USD 1,000/month لتسعير «إعادة المحاولة = رسوم جديدة» كدين مطابقة. يرى العملاء معرفات الأحداث ذات العلامة البيضاء فقط.

التماثل هو مسار فشل وليس شعاراً

المسار السعيد: حدث موقع واحد، قبول واحد، خصم واحد. مسار الفشل يهدم الثقة — مهلة، 5xx، إعادة تشغيل المزود، إعادة دفع المشغل. خزّن مفتاح التماثل من عقد الويب هوك قبل الإرسال الأول قبل الآثار الجانبية: الدفتر، صندوق الوارد، نظام إدارة العملاء. تتعامل المراجعة اللينة بقيمة USD 1,000/month مع «الإقرار ثم ابتكار مفتاح جديد» كدين حجم؛ بينما يثبت مبلغ USD 20 أن إعادة التشغيل القسرية لا تضاعف الأموال أبداً.

ما يُعد تكراراً

تحدد بوابة التوقيع ونافذة إعادة التشغيل الأصالة والجددیدة. تمتلك هذه الصفحة ما يحدث بعد حدوث تكرار صالح: حالة نهائية واحدة، خط أموال واحد، خط صندوق وارد واحد.

يجب ألا تتحرك الأموال مرتين

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

يجب ألا يتضاعف صندوق الوارد أيضاً

التماثل ليس للأموال فقط. حدث وارد أو تسليم معاد تشغيله يفتح خيط صندوق وارد ثانٍ يدرب الدعم على مطاردة الأشباح ويمكن أن يؤدي إلى حلقات رد آلي. خزّن مفتاح صندوق الوارد مع نفس معرف الحدث المستخدم للخصم. يتشارك المنتج والمالية الرفض والتكرار.

قائمة التحقق للمشتري للويب هوك الآمن ضد التكرار

اطلب من مزودك تأكيد تخزين مفتاح التماثل قبل الأثر الجانبي. تحقق من أن اخفاقات الشبكة لا تولد خصماً ثانياً في نفس نافذة UTC. اطلب أن تعيد المحاولات نفس الإقرار المخزن دون مسس الرصيد. اختبر بمبلغ USD 20 قبل الانتقال إلى أحجام أكبر.

البدء مع IOSOR

افرضوا إعادة إرسال واحدة موقّعة داخل النافذة على ممر سبق أن خُصم. صدّروا معرّف الحدث بجانب معرّف الدفتر وأثبتوا صف خصم واحد وصف صندوق وارد واحد. إن ظهر خصم ثانٍ فأوقفوا ذلك المستهلك وأعيدوا الصف الزائد — لا تُصفّوه مع حركة لاحقة. هذا باب مال الإعادة، لا فحص E.164 ولا نص شحن.

خلاصة IOSOR

الإعادة ليست إرسالًا جديدًا. معرّف حدث واحد يكتب خصمًا واحدًا.

افعلوا: أبقوا التوقيع ونافذة الإعادة ثم أثبتوا خصمًا واحدًا بعد POST داخل النافذة. لا تفعلوا: خصم كل POST أو معاملة إعادة الشبكة كفاتورة ثانية.