Recurly

اربط Recurly بمفتاح API خاص، في منطقة الولايات المتحدة أو الاتحاد الأوروبي.

يقرأ RevGlance إصدار API 2021-02-25 من Recurly: فواتير الرسوم المدفوعة، ومعاملات الاسترداد، والاشتراكات.

الربط

في Recurly، افتح Integrations › API Credentials وأضف مفتاح API خاصًا. سمّه RevGlance.
انسخ المفتاح، ودوّن النطاق الفرعي لموقعك: acme للعنوان acme.recurly.com.
املأ المفتاح، والمنطقة التي يُستضاف فيها موقعك (us أو eu) والنطاق الفرعي، ثم اختر ربط Recurly.

أدخل us أو eu كمنطقة. تستخدم المواقع المستضافة في الاتحاد الأوروبي واجهة EU API من Recurly.

في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Recurly واختر Webhook. انسخ العنوان.
في Recurly، افتح Integrations › Webhooks وأضف نقطة نهاية بذلك العنوان بتنسيق JSON.
انسخ سرّ التوقيع الخاص بنقطة النهاية، والصقه في سرّ التوقيع في RevGlance واحفظ.

يتحقق RevGlance من ترويسة recurly-signature ويرفض الاستدعاءات التي مضى عليها أكثر من خمس دقائق.

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

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

تربط استعادة العميل بصفحة حسابه المستضافة على موقعك في Recurly، ولهذا يطلب النموذج النطاق الفرعي.