اختر طريقة الربط حسب مرحلة متجرك، لا حسب شهرة التقنية

الحد الأدنى من بيانات الطلب

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

منع الطلبات المكررة

قد تعيد المنصة إرسال الحدث عند بطء الشبكة. يجب أن يكون الجمع بين معرف المتجر ومعرف الطلب فريداً. أعِد استجابة ناجحة للحدث المكرر من دون إنشاء رسالة ثانية للعميل.

تحديث الحالة

عرّف جدول حالات قبل الربط: جديد، بانتظار رد، مؤكد، يحتاج تعديلاً، ملغى، أُرسل للشحن، مستلم، وغير مستلم. لا تحوّل الطلب مباشرة إلى «مؤكد» لمجرد وصول الرسالة. سجّل المصدر والوقت لكل تغيير كي يستطيع فريق الدعم تفسير ما حدث.

قائمة اختبار من ست نقاط

1. طلب حقيقي في بيئة اختبار.
2. هاتف غير صالح.
3. إعادة إرسال الحدث نفسه.
4. انقطاع مؤقت ثم إعادة المحاولة.
5. إلغاء التطبيق أو تدوير المفتاح.
6. مطابقة الحالة النهائية بين المتجر ولوحة التأكيد.

قرار عملي

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