إعداد Stripe Webhook

سنشرح لكم في هذه المقالة كيفية إعداد روابط الويب الخاصة بـ Stripe MEC يكمل الحجوزات بشكل موثوق، حتى عندما لا يعود العميل إلى موقعك الإلكتروني.

لماذا استخدام Webhooks؟

افتراضيا، MEC يؤكد هذا الإجراء حجزًا عبر Stripe عند إعادة توجيه العميل إلى موقعك الإلكتروني بعد الدفع. إذا أغلق العميل علامة تبويب المتصفح، أو انقطع الاتصال، أو تم حظر إعادة التوجيه، فسيتم إتمام عملية الدفع بنجاح في Stripe، ولكن لن يكتمل الحجز.

باستخدام Webhooks، يقوم Stripe بإخطار موقعك الإلكتروني مباشرةً بشأن عمليات الدفع الناجحة. MEC ثم يقوم النظام بتأكيد الحجز تلقائيًا، بغض النظر عن إعدادات متصفح العميل. وهذا يقلل بشكل كبير من طلبات الدعم المتعلقة بالتذاكر "المدفوعة ولكن غير المحجوزة".

تعمل Webhooks مع كل من بوابات Stripe و Stripe Connect.

ملاحظة: تُعدّ روابط الويب اختيارية، ولكن يُنصح بشدة باستخدامها. بدون رابط ويب، MEC يعود إلى سلوك إعادة التوجيه فقط.

الخطوة 1 - انسخ عنوان URL الخاص بـ Webhook

انتقل إلى البرنامج المساعد في التأليف MEC الإعدادات > الحجز > بوابات الدفع > سترايب وتحديد موقع سرّ الويب هوك الحقل. يعرض النص المساعد أسفل الحقل عنوان URL الخاص بخطاف الويب لموقعك:

https://yourdomain.com/wp-json/mec/v1/stripe/webhook

انسخ هذا الرابط، ستلصقه في لوحة تحكم Stripe الخاصة بك في الخطوة التالية.

الخطوة الثانية - إضافة نقطة النهاية في Stripe

1. تسجيل الدخول إلى الخاص بك لوحة معلومات شريطية.
2. انتقل إلى المطورون > خطافات الويب.
3. انقر أضف نقطة النهاية.
4. ألصق عنوان URL الخاص بـ webhook الذي نسخته في الخطوة 1.
5. تحت اختر الأحداثاختر الحدث التالي فقط:
   • تم تنفيذ نية الدفع بنجاح
6. انقر أضف نقطة النهاية.

الخطوة 3 - نسخ سر التوقيع

بعد إنشاء نقطة النهاية، يعرض Stripe سر التوقيع (يبدأ بـ) whsec_). انقر كشف وانسخها.

الخطوة الرابعة - الصق السر في MEC

مرة أخرى في MEC الإعدادات > الحجز > بوابات الدفع > سترايبالصق سر التوقيع في سرّ الويب هوك قم بتحديد الحقل وحفظ الإعدادات.

هذا هو. MEC يقوم الآن بالتحقق من كل رسالة webhook باستخدام هذا السر، ويتم رفض الطلبات التي لا تأتي من حساب Stripe الخاص بك.

ربط الشريط

إذا كنت تستخدم بوابة Stripe Connect ، فقم بتكوين webhook لحساب منصتك بنفس الطريقة:

1. نمط عنوان URL الخاص بخطاف الويب متطابق (/wp-json/mec/v1/stripe/webhook (على موقعك الإلكتروني).
2. الاشتراك في payment_intent.succeeded.
3. ألصق رمز التوقيع في سرّ الويب هوك حقل إعدادات Stripe Connect.

عند تفعيل وحدة دفع المنظمين وربط المنظمين لحسابات Stripe الخاصة بهم، تتضمن إعدادات كل منظم نفس حقل Webhook Secret لنقطة نهاية الحساب المتصل.

اختبار Webhook الخاص بك

1. تفعيل وضع الاختبار/الوضع التجريبي في إعدادات بوابة Stripe (أو استخدم مفاتيح اختبار Stripe).
2. احجز فعالية مع سترايب بطاقة الاختبار (على سبيل المثال 4242 4242 4242 4242).
3. أغلق علامة تبويب المتصفح فورًا بعد الدفع، قبل حدوث عملية إعادة التوجيه.
4. بعد بضع ثوانٍ، تحقق MEC > الحجوزاتينبغي أن يظهر الحجز على أنه مؤكد، تم تسليمه عبر رابط الويب، وليس عن طريق إعادة التوجيه.

يمكنك أيضًا فحص عمليات التسليم ضمن المطورون > خطافات الويب > نقطة النهاية الخاصة بك في لوحة تحكم Stripe لعرض كل حدث MEC تم الاستلام.

فحص الجهاز

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

"لم يتم تكوين سرّ رابط الويب الخاص بـ Stripe"
حقل Webhook السري في MEC فارغ. أكمل الخطوة 4.

تظهر الفعاليات في Stripe ولكن الحجوزات غير مؤكدة
تأكد من اشتراك نقطة النهاية في payment_intent.succeeded اذا لم تكن checkout.session.completed أو أحداث أخرى)، وأن عنوان URL الخاص بـ webhook يشير إلى نفس الموقع الإلكتروني الذي يحتوي على الحجز.