Braintree
اربط Braintree بزوج مفاتيح API لقراءة المعاملات والفوترة المتكررة.
يقرأ RevGlance واجهة gateway API من Braintree، وهي التي تستخدمها حِزم SDK الخاصة بخوادم Braintree، لأن الفوترة المتكررة لا توجد إلا هناك.
الربط
- في Braintree Control Panel، افتح Settings › API وأنشئ زوج مفاتيح API جديدًا.
- انسخ Merchant ID وPublic key وPrivate key. يحتاج مستخدم API الذي تنتمي إليه هذه المفاتيح إلى دور يتيح قراءة المعاملات والاشتراكات.
- املأها، وأدخل
production(أوsandboxلحساب تجريبي) في البيئة، ثم اختر ربط Braintree.
ما يطلبه النموذج
| الحقل | يبدو مثل |
|---|---|
| Merchant ID | abc123def456ghi7 |
| المفتاح العام | 7xh9k3b2m4n5p6q8 |
| المفتاح الخاصمخزّن بتشفير | 0123456789abcdef0123456789abcdef |
| البيئة | production أو sandbox |
إضافة Webhook
يوقّع Braintree رسائل Webhook بمفاتيح API نفسها التي يحملها المصدر أصلًا، فلا يوجد سرّ للصقه.
- في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Braintree واختر Webhook. انسخ العنوان.
- في Braintree Control Panel، افتح Settings › Webhooks، وأنشئ Webhook بذلك العنوان وحدّد إشعارات الاشتراكات والمعاملات.
ما يزامنه RevGlance
- المعاملات: تصبح المبيعات المسوّاة وقيد التسوية مدفوعات؛ وتصبح الأرصدة الدائنة مبالغ مستردة. تُستبعد التفويضات التي لم تُحصَّل قط.
- الاشتراكات وخططها وإضافاتها وخصوماتها، من أجل MRR والفترات التجريبية والإلغاءات.
تقرأ المزامنة الأولى كل معاملة يحتفظ بها Braintree. لا يبلّغ Braintree عبر API الخاصة به عن رسوم المعالجة ولا عن أسباب الإلغاء.
كيف يُحسب Braintree
- تُحتسب المبيعات المسوّاة والجارية تسويتها، قبل الضريبة إن كنت ترسل مبالغ الضريبة. أما التفويضات التي لم تُحصَّل قط فلا تُحتسب.
- المبالغ المستردة هي معاملات الإيداع، مؤرّخة بيوم إجرائها في Braintree.
- لا يُبلغ Braintree عن رسوم المعالجة عبر API الخاصة به، لذا تظهر الرسوم صفرًا.
- MRR هو سعر الاشتراك مع إضافاته، مطروحًا منه الخصومات التي لا تزال لها دورات فوترة. لا يذكر الاشتراك عميلًا، لذا يأخذ عميل دفعاته؛ والاشتراك الذي لا دفعة له بعد يظهر تحت بطاقته.
- يؤرَّخ الإلغاء من سجل الحالة. وينتهي الاشتراك المنتهي الصلاحية في تاريخ انتهاء فترته المدفوعة.
- يُحتسب الدفع الذي تعذّر تحصيله دفعةً فاشلة. ولا ينقل أي أموال.
- لا تُقرأ عمليات ردّ المبلغ، لذا يبقى الردّ الخاسر محتسبًا دفعةً ما لم يُبلغ عنه المزوّد أيضًا كاسترداد.

RevGlance