Skip to main content

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

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

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

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 التجديد

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

Abandoned Cart Recovery

قم بتكوين تسلسل بريد إلكتروني لـ ACR وحوافز الخصم.

Subscription Dunning

قم بتكوين تسلسل بريد إلكتروني للتجديد للاشتراكات المنتهية.

Subscription Webhooks

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

مخطط حمولة الويب هوك

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
آخر تعديل في ٢٠ أبريل ٢٠٢٦