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. להעתיק את ה-URL.
ב-Recurly, לפתוח את Integrations › Webhooks ולהוסיף endpoint עם ה-URL הזה בפורמט JSON.
להעתיק את סוד החתימה של ה-endpoint, להדביק אותו תחת סוד חתימה ב-RevGlance ולשמור.

RevGlance בודקת את הכותרת recurly-signature ודוחה קריאות שגילן יותר מחמש דקות.

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

חשבוניות חיוב ששולמו נספרות לפני מס.
החזרים הם עסקאות ההחזר שהצליחו. הם כוללים מס, ולכן RevGlance מוריד את המס באותו יחס כמו בחשבונית.
Recurly לא מדווחת על עמלות gateway, ולכן העמלות מוצגות כאפס.
ה-MRR הוא סכום הביניים של Recurly עבור המנוי (סכום ליחידה, כמות ותוספים, אחרי קופונים, לפני מס).
מנוי שבוטל ממשיך להיספר עד שתוקפו פג; מנויים שפג תוקפם, שנכשלו או שהושהו נספרים כנטישה. Recurly לא מספקת סיבת ביטול דרך ה-API.
תשלום שלא ניתן היה לגבות נספר כחיוב שנכשל. לא מועבר כסף.
ביטולי עסקה לא נקראים, ולכן ביטול עסקה שהפסדת נשאר ספור כחיוב, אלא אם הספק מדווח עליו גם כהחזר.

שחזור מקשר את הלקוח לעמוד החשבון המתארח שלו באתר ה-Recurly שלך, ולכן הטופס מבקש את תת-הדומיין.