RevGlanceالمستندات

Polar

اربط Polar برمز وصول المؤسسة وأضف Webhook لمزامنة فورية.

يقرأ RevGlance عملاء مؤسستك على Polar واشتراكاتها وطلباتها برمز وصول المؤسسة. ولا يغيّر أي شيء في Polar أبدًا.

الربط

  1. في Polar، افتح Settings الخاصة بمؤسستك وأنشئ organization access token. سمّه RevGlance.
  2. امنحه النطاقات customers:read وsubscriptions:read وorders:read. أضف customer_sessions:write أيضًا إذا كنت سترسل رسائل الاستعادة بالبريد الإلكتروني.
  3. انسخ الرمز. يبدأ بـ polar_oat_.
  4. الصقه في رمز وصول المؤسسة واختر ربط Polar.

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

الحقليبدو مثل
رمز وصول المؤسسةمخزّن بتشفيرpolar_oat_…

إضافة Webhook

  1. في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Polar واختر Webhook. انسخ العنوان.
  2. في Polar، افتح Settings › Webhooks الخاصة بمؤسستك وأضف نقطة نهاية بذلك العنوان. اختر أحداث الطلبات والاشتراكات والمبالغ المستردة.
  3. انسخ سرّ Webhook (whsec_…)، والصقه في سرّ التوقيع في RevGlance واحفظ.

يوقّع Polar استدعاءاته بطريقة Standard Webhooks. يقبل RevGlance الطريقتين القديمة والحالية اللتين يشتق بهما Polar المفتاح من سرّ whsec_، لذا يعمل السرّ المُنشأ قبل تغيير Polar في سبتمبر 2026 أو بعده.

ما يزامنه RevGlance

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

كيف يُحسب Polar

  • تُحتسب الطلبات قبل الضريبة، مع رسوم منصة Polar كرسوم. وتظهر الرسوم بعملة غير عملة الطلب صفرًا.
  • تُحتسب المبالغ المستردة قبل الضريبة، مثل الدفعة. لا يوفّر Polar تاريخًا للاسترداد، لذا يؤرَّخ الاسترداد بآخر تغيير للطلب.
  • يُلتقط استرداد الطلب الأقدم بقراءة كاملة مرة في الأسبوع، لذا قد يظهر متأخرًا حتى أسبوع.
  • لا تُقرأ عمليات ردّ المبلغ، لذا يبقى الردّ الخاسر محتسبًا دفعةً ما لم يُبلغ عنه المزوّد أيضًا كاسترداد.
  • لا يُبلَّغ عن الدفعات الفاشلة، لذا يبقى هذا الرقم صفرًا.
  • MRR هو مبلغ الاشتراك، الذي يخفّضه Polar مسبقًا بالخصم المتكرر. والخصم لمرة واحدة لا يخفّض MRR.
  • يشمل MRR الضريبة في الأسعار الشاملة للضريبة: فلا يحدّد Polar الاشتراكات التي تستخدمها. وتُحتسب الدفعات والمبالغ المستردة قبل الضريبة.

رسائل الاستعادة

ترسل استعادة العملاء إلى جلسة بوابة العملاء في Polar لتحديث بطاقتهم. يحتاج الرمز إلى customer_sessions:write لذلك؛ وبدونه، يرتبط البريد الإلكتروني بصفحة تحديث البطاقة الخاصة بك.