RevGlanceתיעוד

Chargebee

לחבר את Chargebee עם מפתח API לקריאה בלבד וכתובת webhook שנושאת סוד.

RevGlance קוראת את API v2 של Chargebee: חשבוניות ששולמו, הודעות זיכוי ומנויים. גם אתרים על Product Catalog 2.0 וגם אתרים על הקטלוג הישן עובדים.

חיבור

  1. ב-Chargebee, לפתוח את Settings › Configure Chargebee › API Keys ולהוסיף מפתח read-only לכל הנתונים של האתר.
  2. להעתיק את המפתח (הוא מתחיל ב-live_) ולרשום את שם האתר: acme עבור acme.chargebee.com.
  3. למלא את האתר ואת המפתח, ואז לבחור חיבור Chargebee.

מה הטופס מבקש

שדהנראה כך
אתרacme (מתוך acme.chargebee.com)
מפתח APIנשמר מוצפןlive_…

הוספת ה-webhook

Chargebee לא חותמת על ה-webhooks שלה, ולכן הסוד עובר יחד עם ה-URL.

  1. ב-RevGlance, לפתוח את הגדרות › מקורות, לפתוח את התפריט של מקור ה-Chargebee ולבחור Webhook. לשמור סוד אקראי ארוך תחת סוד חתימה.
  2. להעתיק את כתובת ה-webhook ולהוסיף בסופה ?token= ואת הסוד.
  3. ב-Chargebee, לפתוח את Settings › Configure Chargebee › Webhooks ולהוסיף webhook עם הכתובת הזו. במקום ?token=, אפשר להפעיל אימות בסיסי ולהשתמש בסוד כסיסמה שלו.

מה RevGlance מסנכרנת

  • חשבוניות ששולמו, לפני מס.
  • הודעות זיכוי שניתנות להחזר כהחזרים, בניכוי מס באותו יחס כמו בהודעת הזיכוי.
  • מנויים, עבור MRR, תוכניות, תקופות ניסיון וביטולים, עם קוד סיבת הביטול שהוגדר ב-Chargebee.

Chargebee לא מדווחת על עמלות gateway, ולכן העמלות מוצגות כאפס.

איך Chargebee נספרת

  • חשבוניות ששולמו נספרות לפני מס.
  • החזרים מגיעים מהודעות זיכוי שניתנות להחזר, פחות מס באותו יחס כמו בהודעת הזיכוי.
  • Chargebee לא מדווחת על עמלות gateway, ולכן העמלות מוצגות כאפס.
  • ה-MRR הוא פריטי התוכנית והתוספים, פחות קופונים על החשבונית כולה שממשיכים לחול. חיובים חד-פעמיים לא נכללים.
  • מנויים שלא מתחדשים ממשיכים להיספר עד שהתקופה שלהם מסתיימת. מנויים מושהים נספרים כנטישה. קוד סיבת הביטול שהוגדר ב-Chargebee מוצג כסיבה.
  • תשלום שלא ניתן היה לגבות נספר כחיוב שנכשל. לא מועבר כסף.
  • ביטול עסקה נספר רק כשהודעת זיכוי שניתנת להחזר מתעדת אותו.