الموارد · 47
المدفوعات غير المؤكدة: استعادة عملية الدفع دون تكرار الطلبات
مطابقة تأخيرات الشبكة، وإرجاع المتصفح، والإشعارات، وحالة العمل بدلاً من اعتبار أي إشارة واحدة كافية.
مُحدَّث · 4 min
ما يُساعد هذا الدليل على تحقيقه
- فصل المحاولة والدفع والطلب
- معالجة عمليات الإرجاع المتأخرة أو المفقودة
- إزالة الإشعارات والطلبات المكررة
- شرح حالة عدم اليقين دون مطالبة المستخدمين بالدفع مرة أخرى
فحص سريع
- ما هو مصدر تأكيد الدفع؟
- هل يؤدي إغلاق المتصفح إلى تغيير حالة العمل؟
- هل يؤدي حدث متكرر إلى إعداد طلبين؟
- هل يتم التحقق من توقيعات الأحداث؟
- كيف يكتشف فريق الدعم عملية غير مؤكدة؟
طريقة خطوة بخطوة
- 1
تحديد الحالات
فصل سلة التسوق، ومحاولة الشراء، والتفويض، والدفع المؤكد، والطلب، والاسترداد. كتابة مسارات الانتقال، والمصدر الموثوق، والإجراءات المسموح بها. اتباع مزود الخدمة وطرق الدفع الفعلية؛ لا يتم تأكيد كل طريقة فورًا.
المُخرَج: مخطط الحالة وعقد العمل.
- 2
تحديد العملية.
ربط محاولة الشراء بالطلب ومعرّفات مزود الخدمة. استخدام قاعدة التكرار الموثقة لتكرار نفس العملية. يتطلب الغرض الجديد أو المعلمات المتغيرة قرارًا صريحًا بدلًا من إعادة استخدام المفتاح بشكل أعمى.
المُخرَج: قواعد هوية واسترداد مستقرة.
- 3
معالجة عودة المتصفح.
عرض الحالة من فحص جانب الخادم المناسب لمزود الخدمة. إعادة التوجيه إلى صفحة النجاح وحدها لا تُعد دليلًا على الدفع. تغطية حالات إغلاق المتصفح، وعدم وجود عودة، وانقطاع المصادقة، وبطء الشبكة.
المُخرَج: مسار العودة والرسائل حسب الحالة.
- 4
التحقق من الإشعارات
التحقق من صحة الإشعارات وفقًا لوثائق المزوّد، وتسجيل هوية الحدث، ومعالجة التكرارات دون حدوث آثار مكررة. قد تتأخر الأحداث أو تكون خارج الترتيب. عند الحاجة، استرجع الكائن المرجعي قبل حدوث انتقال غير قابل للعكس.
المُخرَج: معالج مُختَبَر وآثار بدون بيانات بنكية.
- 5
تسوية التناقضات
مقارنة عمليات المزوّد، والطلبات، والتنفيذ. عزل حالات الدفع بدون طلب، والطلب بدون تأكيد، والمعالجة المزدوجة، والمبالغ المستردة غير المُعمَّمة. تحديد مسؤول وإجراء لكل تناقض؛ وعدم تكرار الرسوم غير المؤكدة تلقائيًا.
المُخرَج: قائمة انتظار التسوية والقرارات.
- 6
اختبار الاسترداد الكامل
في وضع اختبار المزوّد، إعادة تشغيل المهلة، والتكرار، والحدث المتأخر، والطلب المعكوس، والمبلغ المسترد المفقود. التحقق من انتقال تجاري واحد، ومعلومات العميل الصحيحة، ودعم الرؤية. تختلف تفاصيل التكرار بين المزوّدين. المخرجات
المخرج: أدلة عدم الازدواجية ومعايير النشر.
مثال عملي افتراضي
حالة توضيحية
مثال توضيحي: تتم عملية الدفع بنجاح، لكن يفقد العميل الاتصال قبل التأكيد، ويصل إشعاران لاحقًا.
القرار والأدلة المتوقعة
تم تأكيد طلب واحد. يعرض قسم الاسترداد حالة "تم التحقق"، ويمكن للدعم مطابقة المرجع دون طلب تفاصيل البنك.
تمييز الآليات
| الآلية | الغرض | التحقق أو التقييد |
|---|---|---|
| عودة المتصفح | إعلام الواجهة واستئنافها | قد يكون مفقودًا أو متقطعًا |
| تم التحقق من رابط الويب | استلام تغيير حالة الموفر | قد يتكرر أو يتأخر أو يكون خارج الترتيب |
| مطابقة الخادم | مقارنة حالة الدفع وحالة الطلب | يحتاج إلى قاعدة لحل التناقضات |
مؤشرات الإدارة
| المؤشر | ما يقيسه | الإجراء الأول |
|---|---|---|
| حالات غير مؤكدة | عمليات لم تُحل خلال التأخير المقصود | التحقق من الحالة المرجعية |
| تأثيرات مكررة | تم تنفيذ الطلبات أو المعالجة مرتين | إصلاح إزالة التكرار في الأعمال |
| سد الثغرات | حالات مطابقة مع القرار والأدلة | معالجة أقدم الحالات وأكثرها أهمية |
الأخطاء الشائعة
- التأكيد من عنوان URL للنجاح فقط
- اعتبار انتهاء المهلة فشلًا في الدفع
- افتراض تصل الأحداث بالترتيب
- تكرار عملية الدفع قبل التحقق
الأسئلة المتكررة
هل يعني انتهاء المهلة فشل العملية؟
لا، هذا يعني عدم استلام الرد خلال فترة التأخير. تحقق من حالة العملية قبل إنشاء عملية أخرى.
هل خاصية التكرار لدى المزوّد كافية؟
لا، يجب أن تتحمل عمليات إنشاء الطلبات وتنفيذها والإشعارات المعالجة المتكررة دون حدوث آثار تجارية مكررة.
ما الذي يجب إبلاغ المستخدم به؟
اشرح أن عملية التحقق جارية، وقدّم مرجعًا آمنًا وطريقة لاستعادة الحالة. تجنّب طلب دفعة أخرى بينما الدفعة السابقة غير مؤكدة.
ما الأدلة التي يجب حفظها لتحقق مفيد؟
احتفظ بمعرفات غير حساسة والحالات ودليل أثر عملي واحد. اربط إعادة المحاولة بعقد API لا بانتهاء المهلة وحده.
Webhooks: التوقيع وإعادة الإرسال
الملاحظات المرجعية المفصّلة متاحة باللغة الإنجليزية في هذه النسخة.
A payment notification does not close reconciliation by itself
Authenticate each webhook, bind it to the right account and compare its effect with authorised server state. A repeated event must not repeat an initial activation; missing events must remain detectable.
- Separate notification identity from the operation to perform.
- Test overlapping manual resend and automatic retry.
- Retain uncertainty after an unknown external result and check the source before retrying.
See webhook signatures, digests and the ten cases →
Sources reviewed on · Stripe · Webhooks · Stripe · Manage webhook endpoints · GitHub · Validating webhook deliveries · GitHub · Best practices for using webhooks · GitHub · Handling failed webhook deliveries
دقة مبالغ API والوحدات الدقيقة
الملاحظات المرجعية المفصّلة متاحة باللغة الإنجليزية في هذه النسخة.
Separate exact conversion from payment confirmation
An interface can display the correct price while preparing an incorrect provider integer. Acceptance must reconcile the server amount with the operation contract, then check confirmed state without mistaking arithmetic for completed payment.
- Test zero-, two- and three-decimal currencies.
- Include a case where step cannot be inferred from decimals.
- Retain an exact reference before localised formatting.
Check a unit in the workshop →
Adyen · Currency codes and minor units · Provider documentation · reviewed 2026-11-06
Stripe · Supported currencies and special cases · Provider documentation · reviewed 2026-11-06
المراجع الرسمية
تدعم المراجع الطريقة. قم بتكييف عمليات التحقق مع سياقك؛ فهي ليست شهادة. قد تكون عناوين المراجع الأصلية والوثائق المصدرية بلغة أخرى.
تاريخ مراجعة المراجع .
- Stripe — Payment status updates
- Stripe — Webhooks
- Stripe — Idempotent requests
- Stripe · Manage webhook endpoints
- GitHub · Validating webhook deliveries
- GitHub · Best practices for using webhooks
- GitHub · Handling failed webhook deliveries
- Adyen · Currency codes and minor units
- Stripe · Supported currencies and special cases
