RevGlanceChargebee
اربط Chargebee بمفتاح API للقراءة فقط وعنوان Webhook يحمل سرًّا.
يقرأ RevGlance واجهة API v2 من Chargebee: الفواتير المدفوعة، والإشعارات الدائنة، والاشتراكات. تعمل المواقع على Product Catalog 2.0 وعلى الكتالوج الأقدم كلاهما.
الربط
- في Chargebee، افتح Settings › Configure Chargebee › API Keys وأضف مفتاحًا read-only لجميع بيانات موقعك.
- انسخ المفتاح (يبدأ بـ
live_) ودوّن اسم موقعك:acmeللعنوانacme.chargebee.com. - املأ الموقع والمفتاح، ثم اختر ربط Chargebee.
ما يطلبه النموذج
| الحقل | يبدو مثل |
|---|---|
| الموقع | acme (من acme.chargebee.com) |
| مفتاح APIمخزّن بتشفير | live_… |
إضافة Webhook
لا يوقّع Chargebee رسائل Webhook، لذا ينتقل السرّ مع العنوان.
- في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Chargebee واختر Webhook. احفظ سرًّا عشوائيًا طويلًا في سرّ التوقيع.
- انسخ عنوان Webhook وأضف
?token=وسرّك إلى نهايته. - في Chargebee، افتح Settings › Configure Chargebee › Webhooks وأضف Webhook بذلك العنوان. بدلًا من
?token=، يمكنك تفعيل المصادقة الأساسية واستخدام السرّ ككلمة مرور لها.
ما يزامنه RevGlance
- الفواتير المدفوعة، قبل الضريبة.
- الإشعارات الدائنة القابلة للاسترداد كمبالغ مستردة، مطروحًا منها الضريبة بالنسبة نفسها التي في الإشعار الدائن.
- الاشتراكات، من أجل MRR والخطط والفترات التجريبية والإلغاءات، مع رمز سبب الإلغاء الذي أعددته في Chargebee.
لا يبلّغ Chargebee عن رسوم البوابة، لذا تظهر الرسوم صفرًا.
كيف يُحسب Chargebee
- تُحتسب الفواتير المدفوعة قبل الضريبة.
- تأتي المبالغ المستردة من إشعارات الدائن القابلة للاسترداد، مطروحًا منها الضريبة بالنسبة نفسها كما في إشعار الدائن.
- لا يُبلغ Chargebee عن رسوم البوابة، لذا تظهر الرسوم صفرًا.
- MRR هو عناصر الخطة والإضافات، مطروحًا منها القسائم على الفاتورة كاملة التي يستمر تطبيقها. وتُستبعد الدفعات لمرة واحدة.
- تبقى الاشتراكات غير المتجددة محتسبة حتى تنتهي مدتها. وتُحتسب الموقوفة مؤقتًا تسرّبًا. ويظهر رمز سبب الإلغاء الذي أعددته في Chargebee كسبب.
- يُحتسب الدفع الذي تعذّر تحصيله دفعةً فاشلة. ولا ينقل أي أموال.
- لا يُحتسب ردّ المبلغ إلا عندما يسجّله إشعار دائن قابل للاسترداد.