RevGlanceالمستندات

Braintree

اربط Braintree بزوج مفاتيح API لقراءة المعاملات والفوترة المتكررة.

يقرأ RevGlance واجهة gateway API من Braintree، وهي التي تستخدمها حِزم SDK الخاصة بخوادم Braintree، لأن الفوترة المتكررة لا توجد إلا هناك.

الربط

  1. في Braintree Control Panel، افتح Settings › API وأنشئ زوج مفاتيح API جديدًا.
  2. انسخ Merchant ID وPublic key وPrivate key. يحتاج مستخدم API الذي تنتمي إليه هذه المفاتيح إلى دور يتيح قراءة المعاملات والاشتراكات.
  3. املأها، وأدخل production (أو sandbox لحساب تجريبي) في البيئة، ثم اختر ربط Braintree.

ما يطلبه النموذج

الحقليبدو مثل
Merchant IDabc123def456ghi7
المفتاح العام7xh9k3b2m4n5p6q8
المفتاح الخاصمخزّن بتشفير0123456789abcdef0123456789abcdef
البيئةproduction أو sandbox

إضافة Webhook

يوقّع Braintree رسائل Webhook بمفاتيح API نفسها التي يحملها المصدر أصلًا، فلا يوجد سرّ للصقه.

  1. في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Braintree واختر Webhook. انسخ العنوان.
  2. في Braintree Control Panel، افتح Settings › Webhooks، وأنشئ Webhook بذلك العنوان وحدّد إشعارات الاشتراكات والمعاملات.

ما يزامنه RevGlance

  • المعاملات: تصبح المبيعات المسوّاة وقيد التسوية مدفوعات؛ وتصبح الأرصدة الدائنة مبالغ مستردة. تُستبعد التفويضات التي لم تُحصَّل قط.
  • الاشتراكات وخططها وإضافاتها وخصوماتها، من أجل MRR والفترات التجريبية والإلغاءات.

تقرأ المزامنة الأولى كل معاملة يحتفظ بها Braintree. لا يبلّغ Braintree عبر API الخاصة به عن رسوم المعالجة ولا عن أسباب الإلغاء.

كيف يُحسب Braintree

  • تُحتسب المبيعات المسوّاة والجارية تسويتها، قبل الضريبة إن كنت ترسل مبالغ الضريبة. أما التفويضات التي لم تُحصَّل قط فلا تُحتسب.
  • المبالغ المستردة هي معاملات الإيداع، مؤرّخة بيوم إجرائها في Braintree.
  • لا يُبلغ Braintree عن رسوم المعالجة عبر API الخاصة به، لذا تظهر الرسوم صفرًا.
  • MRR هو سعر الاشتراك مع إضافاته، مطروحًا منه الخصومات التي لا تزال لها دورات فوترة. لا يذكر الاشتراك عميلًا، لذا يأخذ عميل دفعاته؛ والاشتراك الذي لا دفعة له بعد يظهر تحت بطاقته.
  • يؤرَّخ الإلغاء من سجل الحالة. وينتهي الاشتراك المنتهي الصلاحية في تاريخ انتهاء فترته المدفوعة.
  • يُحتسب الدفع الذي تعذّر تحصيله دفعةً فاشلة. ولا ينقل أي أموال.
  • لا تُقرأ عمليات ردّ المبلغ، لذا يبقى الردّ الخاسر محتسبًا دفعةً ما لم يُبلغ عنه المزوّد أيضًا كاسترداد.