نجاح شاشة الدفع لا يكفي لقبول التكامل. يجب أن يثبت الخادم حالة العملية من مزود موثوق، وأن يحتمل التكرار والتأخير والفشل دون طلبات مزدوجة أو مخزون خاطئ. اختبر المبلغ والعملة والمرجع، لا عبارة «تم الدفع» فقط.
افصل حالات العملية
للطلب حالة تجارية، وللدفع حالة مالية، وللشحن حالة تنفيذ. قد يكون الطلب مقبولاً والدفع معلقاً، أو مدفوعاً ولم يُشحن، أو مسترداً جزئياً. جمعها في علامة نجاح واحدة يجعل معالجة الاستثناءات صعبة. اتفق مع التاجر على الانتقالات المسموحة وتوقيت حجز المخزون وإطلاقه.
صفحة العودة من مزود الدفع ليست الدليل الوحيد. قد يغلق العميل الصفحة بعد الدفع، وقد يعود المتصفح قبل وصول إشعار الخادم. يجب أن يستطيع النظام الوصول إلى النتيجة الصحيحة دون الضغط على زر جديد، مع عرض حالة انتظار مفهومة للمشتري.
مصفوفة الاختبار
| السيناريو | النتيجة المتوقعة |
|---|---|
| رفض الدفع | الطلب لا يظهر مدفوعاً ويُشرح مسار المحاولة الآمنة |
| إشعار نجاح متأخر | تحديث الحالة دون إنشاء طلب آخر |
| تكرار الإشعار | أثر مالي ومخزني واحد |
| مبلغ أو عملة لا تطابق الطلب | إيقاف المعالجة وإحالة للمراجعة |
| دفع ناجح مع إغلاق المتصفح | يمكن استعادة حالة الطلب من الخادم |
| استرداد جزئي | قيمة متبقية صحيحة وسجل مستقل للاسترداد |
| نجاح الدفع بعد انتهاء حجز المخزون | استثناء يعالج وفق سياسة التاجر |
نفّذ هذه الحالات في بيئة المزود التجريبية وبوسائل الاختبار التي يسمح بها، لا بمحاولات غير مصرح بها على الإنتاج. تختلف أسماء الحالات والتواقيع وطرق إعادة الإرسال بين المزودين؛ وثائق المزود الفعلي هي المرجع التنفيذي.
اختبر ما بعد الخطأ
من يرى العملية المتعثرة؟ هل يمكنه إعادة التحقق من المزود دون إعادة الخصم؟ اكتب دليلاً قصيراً يشرح مسؤول المراجعة ومعرفات التتبع والمعلومات التي يمكن مشاركتها مع الدعم. لا تحفظ رقم البطاقة أو بيانات الاعتماد في سجلات التطبيق أو التحليلات.
راجع أيضاً تكرار النقر وإعادة إرسال النموذج من اتصال ضعيف. يجب أن يكون منع الأثر المكرر في الخادم، لا في تعطيل الزر فقط. وإذا استخدمت مفاتيح idempotency، فوثّق عمرها ونطاقها وكيف تتعامل مع إعادة محاولة عملية مختلفة.
مطابقة قبل فتح المتجر
قارن سجل الطلبات بسجل مزود الدفع: القيم والعملات والاستردادات والعمليات المعلقة. لا تعتمد عدد العمليات وحده؛ قد تتساوى الأعداد وتختلف المبالغ. احفظ نتائج الاختبار وإصدار التكامل، واطلب اعتماد صاحب العملية المالية.
توضح خدمة المتاجر المخصصة نطاق المشروع، ويشرح ربط المدفوعات الأساس، بينما يغطي التعامل مع Webhooks التنفيذ المكرر. هذه إرشادات تكامل وليست ادعاء توفر كل ميزة في ShopTek.
مصادر ومراجعة
- Stripe: اختبار المدفوعات.
- Stripe: Webhooks؛ مرجع أمثلة يجب تكييفه مع المزود المستخدم.
- المساهمة الأصلية: مصفوفة قبول تجارية؛ لا تمثل اعتماداً أمنياً أو مالياً.
