Skip to main content

أحداث الويب هوك للفوترة المعتمدة على الرصيد

الأحداث التالية للويب هوك متاحة لتعقب تغييرات دورة حياة الفوترة المعتمدة على الرصيد. تنطبق هذه الأحداث على استحقاقات الاعتماد الافتراضي (استدعاءات API، رموز مميزة، ساعات حوسبة)، ولا تنطبق على محافظ العملاء (الأرصدة النقدية).

أحداث دفتر الأستاذ

تشترك جميع أحداث دفتر الأستاذ (credit.added وحتى credit.manual_adjustment) في نفس الحمولة CreditLedgerEntryResponse الموضحة في المخطط أدناه.

حدث انخفاض الرصيد (credit.balance_low)

يستخدم الحدث credit.balance_low حمولة مختلفة (CreditBalanceLowPayload) تركز على تنبيه العتبة:
string
العميل الذي أدى رصيده من الاعتماد إلى تشغيل التنبيه.
string
الاشتراك المرتبط بهذا الاستحقاق الاعتمادي.
string
الاستحقاق الاعتمادي الذي أصبح رصيده منخفضًا.
string
اسم العرض للاستحقاق الاعتمادي.
string
الرصيد الحالي من الاعتماد وقت حدوث التنبيه.
string
إجمالي الاعتمادات الممنوحة خلال كل دورة فوترة لهذا الاشتراك.
integer
نسبة حد الرصيد المنخفض المكوَّنة.
string
مقدار الاعتماد المطلق الذي تتوافق معه العتبة.

استخدام credit.balance_low لتنبيهات استباقية

استخدم ويب هوك credit.balance_low لإخطار العملاء قبل نفاد اعتماداتهم:
اشترك في credit.balance_low لتنبيه العملاء استباقيًا قبل نفاد اعتماداتهم. اجمعه مع credit.deducted لتتبع أنماط الاستهلاك في الوقت الفعلي.

Get Customer Balance

تحقق من الرصيد الحالي للعميل عبر API.

Create Ledger Entry

قم بمناولة الإضافة أو الخصم يدويًا لرصيد العميل.

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

مخطط حزمة بيانات Webhook

Response for a ledger entry

amount
string
مطلوب
balance_after
string
مطلوب
balance_before
string
مطلوب
brand_id
string
مطلوب

Brand id this credit ledger entry belongs to

business_id
string
مطلوب
created_at
string<date-time>
مطلوب
credit_entitlement_id
string
مطلوب
customer_id
string
مطلوب
id
string
مطلوب
is_credit
boolean
مطلوب
metadata
Metadata · object
مطلوب

Metadata associated with the credit grant's source (the subscription or payment created at checkout). Empty when the grant has no resolvable source (e.g. credits granted directly via the API).

overage_after
string
مطلوب
overage_before
string
مطلوب
transaction_type
enum<string>
مطلوب
الخيارات المتاحة:
credit_added,
credit_deducted,
credit_expired,
credit_rolled_over,
rollover_forfeited,
overage_charged,
overage_reset,
auto_top_up,
manual_adjustment,
refund
description
string | null
grant_id
string | null
reference_id
string | null
reference_type
string | null
آخر تعديل في ٩ يوليو ٢٠٢٦