أحداث المزوّدين
الأحداث الموحّدة التي يحوّل إليها HyoNova كل مزوّد دفع، وكيف تُترجم أحداث FastSpring وTriple-A وStripe، والسجل الزمني للفوترة والإشعارات التي تنتجها.
لا تظهر طريقة الدفع إلا بعد أن يُعدّ HyoNova مزوّد الدفع الخاص بها.
لكل مزوّد لغته. ويترجم كل محوّل إشعارات المزوّد إلى مجموعة صغيرة من الأحداث الموحّدة، ولا تتعامل النواة التجارية إلا معها. وتنتج المطابقة الأحداث نفسها حين تُصلح فرقاً، فيبقى لكل تغيير مسار واحد.
الأحداث الموحّدة#
| المجموعة | الأحداث |
|---|---|
| الدفع | checkout.updated، checkout.completed، checkout.expired، checkout.failed |
| الطلب | order.completed، order.failed |
| الدفعة | payment.succeeded، payment.failed، payment.pending |
| الاشتراك | subscription.activated، subscription.updated، subscription.renewed، subscription.canceled، subscription.uncanceled، subscription.deactivated، subscription.past_due، subscription.paused، subscription.resumed |
| الاسترداد | refund.succeeded، refund.failed |
| التسوية | settlement.reported |
| أخرى | ignored — يُسجَّل ولا يغيّر شيئاً |
يحمل كل حدث موحّد: معرّف حدث فريداً لكل مزوّد، ووقت وقوعه، وهل هو حقيقي، ورقم تسلسل اختيارياً من المزوّد للترتيب، ومعرّفات HyoNova التي يعيدها المزوّد، والجزء المعني — عملية الدفع أو الطلب أو لقطة الاشتراك أو الدفعة أو الاسترداد أو التسوية. والمبالغ أعداد صحيحة بوحدات العملة الصغرى مع عملتها (التعامل مع المال). وتقتصر بيانات البطاقة على النوع وآخر أربعة أرقام وتاريخ الانتهاء.
كيف تُحوَّل أحداث المزوّدين#
| حدث المزوّد | الأحداث الموحّدة |
|---|---|
FastSpring order.completed | order.completed وpayment.succeeded، وsubscription.activated حين يتضمن الطلب اشتراكاً |
FastSpring order.failed | payment.failed |
FastSpring subscription.charge.completed / .failed | payment.succeeded + subscription.renewed، أو payment.failed + subscription.past_due |
FastSpring subscription.payment.overdue | subscription.past_due |
FastSpring subscription.canceled | subscription.canceled (يستمر الوصول حتى نهاية الفترة) |
FastSpring subscription.deactivated | subscription.deactivated (ينتهي الوصول) |
FastSpring subscription.activated و.updated و.uncanceled و.paused و.resumed | حدث الاشتراك المقابل |
FastSpring return.created | refund.succeeded |
FastSpring payoutEntry.created | settlement.reported |
دفعة Triple-A بحالة good | payment.succeeded + checkout.completed |
دفعة Triple-A بحالة hold / short | checkout.updated (قيد التأكيد / مرصودة) |
دفعة Triple-A بحالة invalid | checkout.failed + payment.failed |
Stripe checkout.session.completed / .expired | checkout.completed (+ subscription.activated) / checkout.expired |
Stripe invoice.paid / invoice.payment_failed | payment.succeeded (+ subscription.renewed) / payment.failed |
Stripe customer.subscription.* | حدث الاشتراك المقابل |
Stripe refund.created / .updated | refund.succeeded أو refund.failed حين يصبح نهائياً |
Stripe payout.paid | settlement.reported |
| أي شيء آخر | ignored |
السجل الزمني للفوترة#
يكتب تطبيق الحدث مدخلاً في السجل الزمني لفوترة الشركة. ولكل مدخل مفتاح فريد على مستوى الشركة، فلا يكتبه Webhook مُعاد أو عامل ثانٍ مرتين. والمدخلات التي تخص مسؤولي الفوترة في الشركة تنتج أيضاً إشعاراً — إشعاراً داخل التطبيق ورسالة بريد بالعربية أو الإنجليزية، مرة واحدة لكل حدث ومستلم، ولا تصل إلا إلى الأعضاء القادرين على إدارة الفوترة:
trial.ending، trial.ended، trial.extended، subscription.activated، subscription.renewed، subscription.recovered، subscription.plan_changed، subscription.change_scheduled، subscription.cancel_scheduled، subscription.canceled، subscription.resumed، subscription.past_due، subscription.restricted، subscription.paused، payment.succeeded، payment.failed، invoice.issued، invoice.due، invoice.overdue، invoice.paid، bank_payment.confirmed، refund.completed، credit.issued، renewal.upcoming.
ومن مدخلات السجل الزمني التي لا تنتج إشعاراً: checkout.created وpayment.detected وpayment.overpaid وbank_proof.uploaded وsubscription.updated وsubscription.seats_changed.
هل كانت هذه الصفحة مفيدة؟
شكراً. لا تُجمع تقييمات الصفحات بعد، لذلك لم يُرسَل شيء. إذا وجدت نقصاً أو خطأً فراجع صفحة «الحصول على المساعدة».