Skip to main content

أحداث استرداد سلة التسوق المتروكة

تتبع أحداث الويب هوك التالية دورة حياة استرداد سلة التسوق المتروكة:

حقول حمولات استرداد الخروج المهجور

string
مطلوب
الدفع الأصلي الذي تم التخلي عنه. استخدم هذا للبحث عن تفاصيل المنتج والمبلغ والعملة.
string
مطلوب
العلامة التجارية التي ينتمي إليها هذا checkout المتروك.
string
مطلوب
العميل الذي ترك checkout.
string
مطلوب
سبب ترك checkout. أحد الخيارات التالية:
  • payment_failed — حاول العميل الدفع، لكنه فشل
  • checkout_incomplete — زار العميل checkout، لكنه لم يحاول الدفع
string
مطلوب
الحالة الحالية لدورة حياة محاولة الاسترداد هذه. أحد الخيارات التالية:
  • abandoned — تم الاكتشاف، ولم تُرسل أي رسائل بريد إلكتروني بعد
  • recovering — تم إرسال رسالة بريد إلكتروني واحدة على الأقل للاسترداد
  • recovered — أكمل العميل الدفع
  • exhausted — أُرسلت جميع رسائل البريد الإلكتروني أو تم العثور على checkout أحدث
  • opted_out — ألغى العميل الاشتراك
string
مطلوب
طابع زمني بتنسيق ISO 8601 يحدد وقت اكتشاف أن checkout متروك.
string | null
معرّف الدفع لعملية الدفع الناجحة للاسترداد. null حتى تتم استعادة checkout.

مثال: معالجة Webhooks الخاصة بـ ACR


أحداث Dunning

تتتبّع أحداث Webhook التالية دورة حياة Dunning للاشتراك:

حقول حمولة محاولة Dunning

string
مطلوب
الاشتراك الذي أدّى إلى تشغيل محاولة Dunning.
string
مطلوب
العلامة التجارية التي تنتمي إليها محاولة Dunning هذه.
string
مطلوب
العميل الذي يملك الاشتراك.
string
مطلوب
حالة الاشتراك التي أدّت إلى بدء dunning. إحدى القيم التالية:
  • on_hold — توقفت عمليات التجديد بسبب فشل الدفع
  • cancelled — ألغى العميل الاشتراك من Customer Portal
string
مطلوب
الحالة الحالية لدورة حياة محاولة Dunning هذه. أحد الخيارات التالية:
  • recovering — جارٍ إرسال رسائل Dunning الإلكترونية
  • recovered — حدّث العميل طريقة الدفع ونجحت عملية الدفع
  • exhausted — أُرسلت جميع رسائل البريد الإلكتروني أو تغيّرت حالة الاشتراك
string
مطلوب
طابع زمني بتنسيق ISO 8601 يحدد وقت إنشاء محاولة Dunning.
string | null
معرّف الدفع لعملية الدفع الناجحة للاسترداد. null أثناء الاسترداد.

مثال: معالجة Webhooks الخاصة بـ Dunning

اشترك في كلٍّ من dunning.started وdunning.recovered لتتبّع دورة حياة Dunning الكاملة. استخدم dunning.started لإيقاف فترات السماح مؤقتًا أو وضع علامة على الاشتراكات المعرّضة للخطر في نظامك.

Abandoned Cart Recovery

كوّن تسلسلات رسائل ACR الإلكترونية وحوافز الخصم.

Subscription Dunning

كوّن تسلسلات رسائل Dunning الإلكترونية للاشتراكات المتأخرة.

Subscription Webhooks

أحداث دورة حياة الاشتراك ذات الصلة مثل subscription.on_hold وsubscription.cancelled.

مخطط حمولة Webhook

Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events

abandoned_at
string<date-time>
مطلوب
abandonment_reason
enum<string>
مطلوب
الخيارات المتاحة:
payment_failed,
checkout_incomplete
brand_id
string
مطلوب

Brand id this abandoned checkout belongs to

customer_id
string
مطلوب
payment_id
string
مطلوب
status
enum<string>
مطلوب
الخيارات المتاحة:
abandoned,
recovering,
recovered,
exhausted,
opted_out
recovered_payment_id
string | null
آخر تعديل في ٢١ أغسطس ٢٠٢٦