Webhook Payloads
استرداد
الحمولات المرسلة إلى نقطة نهاية الويب هوك الخاصة بك عند حدوث استرداد سلة التسوق المتروكة أو أحداث التجديد.
أحداث استرداد سلة التسوق المتروكة
تتبع أحداث الويب هوك التالية دورة حياة استرداد سلة التسوق المتروكة:حقول حمولات استرداد الخروج المهجور
string
مطلوب
الدفع الأصلي الذي تم التخلي عنه. استخدم هذا للبحث عن تفاصيل المنتج والمبلغ والعملة.
string
مطلوب
العميل الذي تخلى عن الخروج.
string
مطلوب
سبب التخلي عن الخروج. أحدهم:
payment_failed— حاول العميل الدفع لكنه فشلcheckout_incomplete— زار العميل الخروج لكنه لم يحاول الدفع أبدًا
string
مطلوب
حالة دورة الحياة الحالية لمحاولة الاسترداد هذه. أحدهم:
abandoned— تم الكشف، لم يتم إرسال أي رسائل بريد إلكتروني بعدrecovering— تم إرسال بريد إلكتروني للاسترداد على الأقلrecovered— أكمل العميل الدفعexhausted— تم إرسال جميع الرسائل الإلكترونية أو تم العثور على خروج أحدثopted_out— الغاء الاشتراك من قبل العميل
string
مطلوب
ISO 8601 طابع زمني عند اكتشاف الخروج على أنه مهجور.
string | null
معرّف الدفع لاسترداد الدفع الناجح.
null حتى يتم استرداد الخروج.مثال: التعامل مع Webhooks ACR
أحداث التجديد
تتبع أحداث الويب هوك التالية دورة حياة التجديد:حقول حمولات محاولة التجديد
string
مطلوب
الاشتراك الذي أثار محاولة التجديد.
string
مطلوب
العميل الذي يمتلك الاشتراك.
string
مطلوب
حالة الاشتراك التي أثارت التجديد. أحدهم:
on_hold— تم إيقاف الاشتراك مؤقتًا بسبب فشل الدفعcancelled— ألغى العميل من بوابة العميل
string
مطلوب
حالة دورة الحياة الحالية لمحاولة التجديد هذه. أحدهم:
recovering— يتم إرسال رسائل البريد الإلكتروني للتجديدrecovered— قام العميل بتحديث طريقة الدفع وتم الدفع بنجاحexhausted— تم إرسال جميع الرسائل الإلكترونية أو تم تغيير حالة الاشتراك
string
مطلوب
ISO 8601 طابع زمني عند إنشاء محاولة التجديد.
string | null
معرّف الدفع لاسترداد الدفع الناجح.
null أثناء الاسترداد.مثال: التعامل مع Webhooks التجديد
Abandoned Cart Recovery
قم بتكوين تسلسل بريد إلكتروني لـ ACR وحوافز الخصم.
Subscription Dunning
قم بتكوين تسلسل بريد إلكتروني للتجديد للاشتراكات المنتهية.
Subscription Webhooks
أحداث دورة حياة الاشتراك ذات الصلة مثل
subscription.on_hold وsubscription.cancelled.مخطط حمولة الويب هوك
Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events
الخيارات المتاحة:
payment_failed, checkout_incomplete Brand id this abandoned checkout belongs to
الخيارات المتاحة:
abandoned, recovering, recovered, exhausted, opted_out آخر تعديل في ٢٠ أبريل ٢٠٢٦