معالجة الأحداث / WEIM
يتطلب تحديد هوية الحدث وترتيب الوصول أدلة منفصلة.
يتلقى نظام الدفع المقترح صراحةً إشعارًا ويُحدّث سجلّ المُشغّل. يُعاد إرسال نفس الحدث بعد إعادة المحاولة. إذا كان عرض المشروع يُحصي الإشعارات بدلًا من التأثيرات التجارية النهائية، فقد يغفل المشتري عن معالجة حدثٍ ما مرتين. هذا سيناريو افتراضي، وليس عطلًا مُلاحَظًا في نظام البيع أو عملية دفع حقيقية.
وثائق الويب هوك الرسمية من Stripe بحسب ما ورد في وثيقة نُشرت بتاريخ ١١ أكتوبر ٢٠٢٦ عبر أداة التوثيق العامة الخاصة بها، يُمكن أن يستقبل الجهاز نفس الحدث أكثر من مرة، ولا يُضمن ترتيب التسليم. وتوصي الوثيقة بتسجيل معرّفات الأحداث المُعالجة وعدم معالجة تلك المُسجلة مُسبقًا. هذه معلومات خاصة بعرض Stripe مُحدد.
لا يدّعي هذا الدليل أن أي جهاز من أجهزة WEIMI يدعم Stripe، أو تسجيل رابط ويب، أو معالجة المدفوعات، أو إعادة المحاولة المباشرة. المنتجات الثلاثة الأصلية المذكورة أدناه هي قائمة مختصرة للأجهزة متاحة للعموم. يُرجى التأكد من نطاق الدفع والخدمة بشكل منفصل. لا يُجرى أي اختبار مستقل للأجهزة أو التكامل.
اطلب نتائج التسليم المتكرر والوصول غير المرتب مع دليل على حالة العمل النهائية. في حالة تكرار الحدث نفسه، يجب على المزوّد إثبات عدم تطبيق التأثير التجاري المقصود مرة أخرى. أما بالنسبة للأحداث التي تصل بشكل مختلف، فيجب ألا يعتمد سير العمل على تسلسل الوصول الأصلي.
يميز Stripe بين الحدث نفسه المُعاد إرساله وبين كائنات الأحداث المنفصلة التي تمثل نسخًا مكررة. ويوصي بتتبع مُعرّف الحدث لإعادة الإرسال، واستخدام مُعرّف كائن البيانات مع نوع الحدث في الحالات الأخيرة. اطلب من المُنفِّذ شرح التنسيق الفعلي وقاعدة العمل؛ فليست كل الأحداث المتعلقة بكائن واحد قابلة للتبديل.
لا تفترض أن تأكيد استلام الدفعة (2xx) يعني إتمام العمليات اللاحقة. توصي Stripe بالاستجابات السريعة والناجحة قبل اللجوء إلى العمليات المعقدة، وتناقش المعالجة غير المتزامنة. اطلب النتيجة النهائية المرجوة، وليس فقط حالة تسليم المرسل.
تُفرّق هذه الحالات المقترحة التي يتحكم بها المزوّد بين هوية التسليم، وهوية العمل، وحالة المعالجة. لم يتم إرسال أي حدث مباشر لهذه المقالة.
| قضية | حقائق التسليم | طلب تقديم الأدلة | خطأ في الشراء |
|---|---|---|---|
| تم إعادة تقديم نفس الحدث | إمكانية التوصيل المتكرر | تأثير أخير للحدث الذي تمت معالجته بالفعل | كل عملية تسليم تصبح إجراءً جديداً |
| كائنات الأحداث المكررة المنفصلة | قد تحتوي النسخ المكررة من الأعمال على معرفات أحداث مختلفة | قاعدة تعريف معرّف الكائن/نوع الحدث | المعرفات المميزة تعني دائمًا تأثيرات مميزة |
| وصول الطلبات بترتيب جديد | طلب التوصيل غير مضمون | الحالة النهائية المتفق عليها الصحيحة | يؤدي الوصول المبكر دائمًا إلى تهيئة المهمة اللاحقة |
| إقرار 2xx | خدمة التوصيل مقبولة | أدلة إتمام المعالجة | التسليم يعني إنجاز المهمة التجارية |
| إعادة إرسال يدوية بعد الفشل | قد تستمر المحاولات التلقائية | نتيجة مشتركة آمنة للتكرار | يؤدي النجاح اليدوي إلى إلغاء المحاولات اللاحقة |
استخدم هذا الموجز فقط إذا اقترح المورّد صراحةً دمج الأحداث عبر Stripe. يمكن أن يساعد ذلك في مراجعة السجلات المرتبطة، أو إعداد التقارير، أو أي مهمة تجارية أخرى محددة. لا تُعدّ ميزة الدفع الإلكتروني دليلاً على دعم Stripe، أو نقطة نهاية webhook، أو تصميم تنفيذ الطلبات.
ينبغي على صاحب العمل تحديد الهدف من كل حدث. وعلى مزود التكامل تحديد الهوية، ومعالجة البيانات المكررة، وحالة المعالجة. كما ينبغي على مسؤول الدعم معرفة كيفية تصعيد حالات فشل التسليم والمعالجة غير المحلولة. لذا، يجب التوفيق بين هذه المسؤوليات قبل قبول الخدمة.
غالباً ما تُظهر العروض التوضيحية إشعاراً واحداً ناجحاً. يُعدّ هذا دليلاً مفيداً على مسار التسليم، ولكنه لا يُثبت حدوث التأثير المطلوب على العمل عند إعادة التسليم أو استمرار صحته عند إعادة ترتيب عمليات الوصول. اطلب هذه النتائج دون افتراض وجود خلل في التنفيذ.
نستخدم بيانات WEIMI العامة المحفوظة، والتي تمت مراجعتها في 10 أكتوبر 2026، لثلاثة نماذج بيع بالتجزئة. نقارن خيارات الوصول والتوزيع، وليس جودة تكامل المعالج. لم يتم التحقق من أي إعدادات لـ Stripe، أو تطبيق Webhook، أو نتائج معالجة الأحداث لأي مرشح.
أولًا، حدد اسم المزوّد، وأنواع الأحداث المُشترك بها، والإجراءات التجارية. واحرص على أن يقتصر نطاق البحث على العرض الفعلي. لا يُعدّ عرض توضيحي للدفع باستخدام ترتيب آخر دليلًا على سلوك Stripe webhook. لا تستنتج أمر بيع عن بُعد قائم على حدث من شاشة لمس.
ثانيًا، اسأل عن كيفية تسجيل المزوّد للحدث الذي تمت معالجته بالفعل، وكيف يربط تلك الحالة بالإجراء المكتمل. لا ينبغي للمشتري أن يفرض شروط احتفاظ عشوائية أو بنية تنفيذية دون معرفة متطلبات التسليم والاسترداد الفعلية.
ثالثًا، مراجعة الحالات التي يتحكم بها المزوّد والتي لا تُسبب أي ضرر: تكرار نفس الحدث، وإعادة ترتيب التسلسل المتفق عليه، وفشل المعالجة بعد قبول التسليم. يجب الاحتفاظ بمراجع اختبار آمنة تربط نتيجة تسليم المُرسِل بالسجل النهائي للتطبيق. تبقى تجارب حزمة الأجهزة مسار قبول منفصل.
قد تتكرر عملية التسليم. تشير Stripe إلى أن نقاط النهاية قد تتلقى نفس الحدث أكثر من مرة. استفسر عن كيفية تسجيل معرّفات الأحداث المُعالجة، وكيف يمنع إعادة التسليم تكرار الإجراء المقصود. لا يُعدّ استلام طلب ثانٍ خطأً بحد ذاته، بل إنّ التأثير غير المقصود الثاني هو ما يُثير القلق بشأن قبول الطلب.
يمكن استخدام كائنات أحداث منفصلة للتكرارات التجارية. يشرح الدليل استخدام خاصية `data.object identity` ونوع الحدث `event.type` لتحديد هذه التكرارات. استفسر عن كيفية تطبيق ذلك على البيانات والمهمة الفعلية. لا تقم بدمج جميع الأحداث في كائن دفع واحد، لأن أنواع الأحداث المختلفة قد يكون لها أغراض مختلفة.
لا يُضمن ترتيب وصول البيانات. تنصّ Stripe على أنه لا يجب على المُستقبِلين الاعتماد على تسلسل مُحدد، وتشرح كيفية استرجاع العناصر المفقودة عبر واجهة برمجة التطبيقات (API) الخاصة بها عند الحاجة. يجب على المُنفِّذ شرح آلية الاسترجاع. لا تُجري هذه المقالة أي استرجاع ولا تُقدّم خوارزمية معالجة كاملة.
لا تُعدّ الطوابع الزمنية اختصارًا. تشير الوثائق الحالية إلى أن الطوابع الزمنية المُنشأة في اللقطات تُقاس بالثواني، وقد تشترك أحداث مختلفة في طابع زمني واحد. لذا، يُنصح بعدم استخدام تاريخ الإنشاء لتحديد الترتيب أو ما إذا كان الحدث قد عُولج. اطلب أدلة تستند إلى الهوية بدلًا من الاعتماد على فلتر الطابع الزمني فقط.
تختلف قواعد إعادة المحاولة باختلاف مزود الخدمة. تُوثّق Stripe إعادة المحاولات التلقائية في الوضع المباشر لمدة تصل إلى ثلاثة أيام مع تراجع أُسّي وسلوك مختلف في بيئة الاختبار. اعتبر ذلك بمثابة قراءة السياق في التاريخ المُحدد، وليس قاعدة عامة لخطاف الويب أو وقت استرداد مُحدد لتطبيق البيع الآلي.
إعادة الإرسال اليدوي لا تلغي دورة حياة الحدث. يشير المصدر إلى أن إعادة الإرسال اليدوي لحدث فاشل لا تلغي محاولات إعادة الإرسال التلقائية حتى بعد تلقي استجابة 2xx. استفسر عن كيفية ضمان سلامة المهمة من التكرار عبر كلا المسارين. لا تقم بإعادة إرسال حدث مباشر بشكل عشوائي كاختبار.
لا يُعدّ الإقرار بالاستلام إنجازًا. توصي Stripe باستجابات سريعة (2xx) قبل التعامل مع المهام المعقدة والمعالجة غير المتزامنة. استفسر عن حالة قبول الحدث، أو وضعه في قائمة الانتظار، أو معالجته، أو ما إذا كان لا يزال قيد الإنجاز، ومن المسؤول عن كل مرحلة. لا يُعدّ استلام الشارة دليلاً على إتمام المراحل اللاحقة.
التحقق من المصداقية أمرٌ منفصل. تُوجّه Stripe المُنفّذين إلى التحقق من مصدر الحدث والتوقيعات قبل اتخاذ أي إجراء، وتتطلب نص الطلب الخام للتحقق من التوقيع. لا يُؤدّي التعامل مع البيانات المُكرّرة إلى هذه الفحوصات. اطلب تأكيدًا منفصلاً دون جمع أسرار التوقيع أو تغيير بيانات الاعتماد.
تصف هذه القوائم الحقيقية لـ WEIMI ثلاثة نماذج بيع بالتجزئة. لا يوجد أي منها يؤكد دعم Stripe أو سير عمل webhook. يجب تضمين توافق معالج الطلبات ومسؤولية التكامل في العرض النهائي.
نطاق البيع بالتجزئة 1
يصف الإعلان خاصية التعرف على الكاميرا، وخمسة مستويات للأرفف مع خمس سلال، وشاشة علوية أو صندوق إضاءة. تأكد من إعدادات التبريد والعرض. هذا المنتج مخصص للبيع بالتجزئة، وليس لتحضير العصائر.
في حال اقتراح سير عمل Stripe، حدد أي حدث يُغيّر أي سجل للمشغل. لا يُحدد التعرف بالكاميرا أي دلالات لأحداث الدفع. احتفظ بنتائج تجربة التعرف ونتائج التكامل منفصلة.
اقرأ الأدلة العامة للمنتجنطاق البيع بالتجزئة 2
تصف الصفحة شاشة لمسية مقاس 21.5 بوصة، ونظام تبريد، ونظام إدارة المخزون. تتطلب خيارات التعبئة الحلزونية، والناقلة، والدفع المباشر، والتعليق تأكيد الطلب. جرّب العبوات الفعلية باستخدام الآلية المختارة.
بالنسبة لسير عمل حدث الدفع المُقدّم صراحةً، حدّد أي علاقة بسجلات المخزون والآثار التجارية الأخرى. لا تستنتج وجود أمر بيع عن بُعد أو دعم معالج من الشاشة. احصل على نطاق الخدمة مكتوبًا.
اقرأ الأدلة العامة للمنتجنطاق البيع بالتجزئة 3
تعرض الصفحة خزانة عرض رئيسية بالإضافة إلى منطقة تخزين حلزونية مرئية أخرى. لم يتم تحديد البرامج المشتركة والتبريد المستقل والسعة الدقيقة هنا. يرجى التأكد من نطاق المحطة المطلوبة.
إذا تم اقتراح خدمة دفع مشتركة، فاسأل عن السجلات ومراجع الخزائن التابعة لكل مهمة. لا تُنشئ منطقتان حساب معالج مشترك أو معالج أحداث. استخدم البنية المقترحة فعليًا.
اقرأ الأدلة العامة للمنتجتُساعد مواصفات الأجهزة في اختيار القائمة المختصرة، ولكن لا تُنشئ حسابات معالجات أو اشتراكات في الأحداث أو عناصر تحكم مكررة. تأكد من عرض البرنامج الفعلي أولاً.
| مُرَشَّح | المرافق العامة | طلب التكامل | الحدود |
|---|---|---|---|
| ثلاجة مزودة بتقنية الرؤية الذكية | التقدير والوصول إلى الرفوف | ربط الحدث بالسجل إذا كان ذلك متاحًا | لا توجد دلالات مستنتجة لـ Stripe |
| WM22 | خيارات شاشة اللمس والآليات | الدفع الكتابي وتدفق المخزون | لا يُفترض وجود بائع عن بُعد |
| محطة مزدوجة | الخزانة الرئيسية ومنطقة تخزين إضافية | نطاق سجل الخدمة المشتركة الفعلي | لم يتم استنتاج معالج أحداث مشترك |
تقدير افتراضي لوقت مراجعة العمل: لنفترض 55 دقيقة لتحديد العلاقة بين الحدث والعمل، و60 دقيقة لمراجعة النسخ المكررة الخاضعة للرقابة وأدلة الطلب، و35 دقيقة لتسجيل مسؤولية الفشل. المجموع 150 دقيقة، أي ساعتان ونصف. بافتراض أن سعر الساعة 41 دولارًا أمريكيًا، فإن تكلفة العمل 102.50 دولارًا أمريكيًا.
لنفترض متابعة لاحقة لمدة 30 دقيقة بنفس السعر، بتكلفة 20.50 دولارًا أمريكيًا. يبلغ إجمالي المخصصات التوضيحية 123 دولارًا أمريكيًا. هذه مدخلات تخطيط افتراضية، وليست رسوم Stripe أو أسعار تكامل WEIMI أو تكاليف فعلية.
لا يشمل هذا المبلغ تكاليف التنفيذ والاستضافة والاختبارات المتخصصة. يُرجى الحصول على عروض أسعار فعلية. لا يتوقع هذا المبلغ أي خسائر مكررة، أو زيادة في المبيعات، أو استرداد تكلفة المعدات. لا تزال أرباح التجزئة بحاجة إلى بيانات فعلية عن الطلب على الموقع، وهوامش الربح، وتكاليف التشغيل، مع مطابقة سجلات الأعمال.
يتكرر الحدث نفسه: اطلب مرجعه المُعالَج وحالته النهائية. اعرض أحد التأثيرات المقصودة بدلاً من الاعتماد فقط على سجل الرسائل المُتجاهلة. ميّز بين الاستلام والمعالجة.
تصل الأحداث ذات الصلة بترتيب عكسي: اطلب الحالة النهائية المتفق عليها دون افتراض التسلسل الأصلي. استخدم مسار استعادة المعلومات المفقودة الموثق بدلاً من ابتكار قاعدة طابع زمني عالمية.
إعادة الإرسال يدويًا في حال الفشل: راجع النتيجة مع عمليات التسليم التلقائية المحتملة. تشير Stripe إلى أن نجاح الإرسال يدويًا لا يلغي محاولات إعادة الإرسال التلقائية. حافظ على النتيجة المرجوة في كلا المسارين.
في حال فشل العمليات اللاحقة بعد قبولها: حدد حالة المعالجة غير المكتملة وحدد المسؤول عنها. اطلب استعادة مُتحكَّم بها وإكمالًا آمنًا من التكرار. لا ينبغي أن يؤدي إشعار 2xx إلى إغلاق مهمة غير مكتملة.
يُقترح مزود خدمة آخر: استخدم وثائقه الحالية. لا يجوز نقل قواعد التوقيت والهوية الخاصة بـ Stripe إلى معالج آخر دون تقديم دليل.
أنشئ سجل أحداث يتضمن المزوّد، والبيئة، ونوع الحدث الفعلي، ومرجع اختبار الأمان، والإجراء المقصود، وأدلة المعالجة، ونتيجة التسليم المتكرر، ومالك الدعم. هذا سجل مشتريات مقترح، وليس ميزة من ميزات WEIMI. استبعد البيانات المالية المباشرة وأسرار التوقيع.
وافق على أحداث الاختبار غير الضارة وسجلات الهدف. يجب على المزوّد المُرخّص إثبات وجود حالات مُكرّرة وغير مُرتّبة في بيئة الاختبار الخاصة به. لا تُنشئ هذه المقالة أي حساب مُعالج، ولا تُسجّل أي نقطة نهاية، ولا تُعيد تشغيل أي حدث مباشر.
احتفظ بسجلات التسليم وسجلات العمل معًا. يجب أن يُميّز المرجع الآمن بين النقل المقبول، والعمل المُدرج في قائمة الانتظار، والحالة المكتملة. سجّل حالات الفشل غير المُعالجة حتى لا تُخفي حالة التسليم الأعمال غير المكتملة في المراحل اللاحقة.
عند تغيير الاشتراكات أو تنسيقات البيانات أو عمليات ربط الأعمال، يُرجى إعادة فتح الحالات ذات الصلة. تغطي الأدلة السابقة نطاقها الموثق. يجب إجراء عمليات الاعتراف والتوزيع والتبريد بشكل منفصل وفقًا لطلب الأجهزة النهائي.
تشير وثائقها إلى أن ترتيب التسليم غير مضمون. لا ينبغي للمستلمين الاعتماد على تسلسل معين.
نعم. توصي Stripe بتسجيل معرفات الأحداث التي تمت معالجتها وعدم معالجة تلك المسجلة بالفعل مرة أخرى.
يقول المصدر الحالي إنه يمكن مشاركة الطوابع الزمنية للقطات، ولا ينبغي أن تحدد هوية المعالجة أو ترتيبها.
لا. يتطلب إقرار التسليم وإتمام الإجراءات اللاحقة أدلة منفصلة.
تقول شركة Stripe إنها لا تفعل ذلك، حتى عندما يتلقى هذا التسليم اليدوي 2xx.
لا. يجب الحصول على توافق المعالج ونطاق التكامل الخاص بالمشروع كتابيًا.
يجب تحقيق الأثر التجاري النهائي في حالة التسليم المتكرر وغير المنظم، وليس مجرد إشعار ناجح. حدد عملية ربط الأحداث الفعلية، واحفظ أدلة المعالجة الآمنة، وحدد مسؤولية الاسترداد. تنطبق هذه الأسئلة الخاصة بـ Stripe فقط في الحالات التي يُقترح فيها استخدام Stripe فعليًا.
اختر الأجهزة من خلال المعلومات المتاحة للجمهور وتجارب الباقات، ثم تأكد من توافق المعالج بشكل منفصل. لا تتضمن هذه المقالة أي عملية دفع، ولا تعيد إرسال أي حدث مباشر، ولا تتحقق من تكامل Stripe مع القائمة المختصرة.
