RevGlanceתיעוד

Lemon Squeezy

לחבר את Lemon Squeezy עם מפתח API ו-webhook חתום.

RevGlance קוראת עם מפתח API את המוצרים, הלקוחות, ההזמנות, המנויים וחשבוניות המנויים של חנות ה-Lemon Squeezy שלך.

חיבור

  1. ב-Lemon Squeezy, לפתוח את Settings › API וליצור מפתח API חדש. לקרוא לו RevGlance.
  2. להעתיק את המפתח מיד: Lemon Squeezy מציגה אותו פעם אחת בלבד.
  3. להדביק אותו תחת מפתח API ולבחור חיבור Lemon Squeezy. RevGlance קוראת מוצרים, לקוחות, הזמנות, מנויים והחשבוניות שלהם.

מה הטופס מבקש

שדהנראה כך
מפתח APIנשמר מוצפןeyJ0eXAiOiJKV1Qi…

הוספת ה-webhook

  1. ב-RevGlance, לפתוח את הגדרות › מקורות, לפתוח את התפריט של מקור ה-Lemon Squeezy ולבחור Webhook. להעתיק את ה-URL.
  2. ב-Lemon Squeezy, לפתוח את Settings › Webhooks ולהוסיף webhook עם ה-URL הזה. להמציא signing secret אקראי וארוך ולבחור את האירועים של הזמנות, מנויים ותשלומי מנויים.
  3. להדביק את אותו סוד תחת סוד חתימה ב-RevGlance ולשמור.

מה RevGlance מסנכרנת

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

איך Lemon Squeezy נספרת

  • חיובים הם סך ההזמנה או החשבונית פחות מס.
  • Lemon Squeezy מדווחת על החזרים כולל מס, ולכן RevGlance מוריד את המס באופן יחסי. מדי פעם צפוי הפרש עיגול של סנט.
  • החזרים מלאים מתוארכים למועד שבו Lemon Squeezy ביצעה אותם. להחזרים חלקיים אין תאריך, ולכן הם מוצגים בתאריך החשבונית.
  • מנוי שבוטל ממשיך להיספר עד שתקופת התשלום שלו מסתיימת. מנוי לא משולם (ארבעה ניסיונות חוזרים שנכשלו) נספר כנטישה, וחוזר אם התשלום מתאושש.
  • Lemon Squeezy לא שולחת תאריך ביטול או סיבה: תאריך הביטול הוא המועד שבו המנוי השתנה לאחרונה.
  • Lemon Squeezy לא מדווחת על עמלות, ולכן העמלות מוצגות כאפס.
  • הנחה מופחתת מה-MRR ברגע שחידוש מציג אותה. Lemon Squeezy לא מציינת אם הנחה חוזרת, ולכן הנחה שמופיעה רק בחשבונית הראשונה לא נספרת.
  • החזר על הזמנה ישנה יותר נתפס בקריאה מלאה פעם בשבוע, ולכן הוא עשוי להופיע באיחור של עד שבוע.
  • תקופת ניסיון שהומרה לפני החיבור לא מוצגת, כי Lemon Squeezy מציינת תקופת ניסיון רק בזמן שהיא פעילה.
  • ביטולי עסקה לא נקראים, ולכן ביטול עסקה שהפסדת נשאר ספור כחיוב, אלא אם הספק מדווח עליו גם כהחזר.