اجعل Webhooks المالية آمنة عند التكرار

تعتمد بوابات الدفع على إعادة المحاولة عندما لا يصلها رد واضح، وقد يصل Webhook نفسه مرتين أو بالتوازي. إذا نفذ النظام الإيداع عند كل وصول، يمكن أن يضيف الرصيد أكثر من مرة رغم أن الدفع حدث مرة واحدة.

استخدم معرّف الحدث أو العملية الذي يقدمه المزود عندما يكون فريدًا وثابتًا، أو أنشئ UUID ومفتاح Idempotency واحفظه قبل إرسال الطلب الأول. خزّن المعرّف في عمود عليه قيد UNIQUE؛ ولا تولّد المفتاح من الدقيقة أو الوقت وحدهما، لأن التصادم وإعادة المحاولة سيجعلان السلوك غير موثوق.

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