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. להעתיק את ה-URL.
  2. ב-Polar, לפתוח את Settings › Webhooks של הארגון ולהוסיף endpoint עם ה-URL הזה. לבחור את האירועים של הזמנות, מנויים והחזרים.
  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; בלעדיו, האימייל מקשר לעמוד עדכון הכרטיס שלך.