Stripe

לחבר את Stripe עם מפתח מוגבל לקריאה בלבד, ואז להוסיף webhook כדי שתשלומים חדשים יופיעו מיד.

RevGlance קוראת את חשבון ה-Stripe שלך דרך ה-API של Stripe עם מפתח שיוצרים בעצמך. היא קוראת חיובים, החזרים, עמלות, מחלוקות ומנויים, ואף פעם לא מחייבת, מחזירה כסף או משנה משהו.

לפני שמתחילים

צריך להיות בעלים או מנהל מערכת של העסק ב-RevGlance. צופים לא יכולים להוסיף מקורות.
כדאי להשתמש ב-restricted key ולא במפתח הסודי. RevGlance מקבלת את שניהם (rk_… או sk_…), אבל מפתח מוגבל יכול לקרוא רק את מה שמאפשרים לו.
גם מפתחות של מצב בדיקה עובדים, וזה נוח להצצה ראשונה. כשמוכנים, אפשר לחבר מקור שני עם מפתח ה-live.

חיבור

ב-Stripe Dashboard, לפתוח את Developers › API keys ולבחור Create restricted key. לקרוא לו RevGlance.
לתת לו גישת Read ל-Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions ו-Coupons. את כל השאר להשאיר על None.
ליצור את המפתח ולהעתיק אותו. הוא מתחיל ב-rk_live_.
להדביק אותו תחת מפתח מוגבל ולבחור חיבור Stripe. הסנכרון הראשון קורא את כל ההיסטוריה.

מה הטופס מבקש

שדה	נראה כך
מפתח מוגבלנשמר מוצפן	`rk_live_…`

השדה שם הוא אופציונלי. הוא עוזר להבדיל בין שני חשבונות Stripe באותו עסק.

הוספת ה-webhook

בלי webhook, RevGlance מסנכרנת את Stripe כל שעה. עם webhook, תשלום, החזר או ביטול חדש מכניסים סנכרון לתור תוך שניות.

ב-RevGlance, לפתוח את הגדרות › מקורות, למצוא את מקור ה-Stripe, לפתוח את התפריט שלו ולבחור Webhook. להעתיק את ה-URL.
ב-Stripe, לפתוח את Developers › Webhooks ולהוסיף endpoint עם ה-URL הזה.
לבחור את האירועים שמשנים את המספרים: charge.succeeded, charge.failed, charge.refunded, charge.dispute.closed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted ו-invoice.paid. כל אירוע עובד: כל אחד מהם פשוט מפעיל סנכרון.
להעתיק את ה-signing secret של ה-endpoint (whsec_…), להדביק אותו תחת סוד חתימה ב-RevGlance ולשמור.

מה RevGlance מסנכרנת

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

הסנכרון הראשון קורא את כל ההיסטוריה. אחריו כל סנכרון קורא משלושה ימים לפני הסנכרון האחרון, כדי לתפוס שינויים מאוחרים, והמנויים נקראים במלואם בכל פעם.

איך Stripe נספרת

חיובים, החזרים והעמלות של Stripe מגיעים מתנועות היתרה שלך, במטבע שבו Stripe סגר אותם.
החזרים בכרטיס נספרים ביום שבו Stripe רושם אותם. גם תשלומים בנקאיים (ACH, SEPA ושיטות מקומיות אחרות) נספרים; החזר שהבנק מחזיר מקטין שוב את ההחזרים שלך.
מחלוקת נספרת כהחזר כש-Stripe לוקח את הכסף בחזרה, וההחזר מבוטל אם זוכים בה. עמלת המחלוקת של Stripe נשמרת כעמלה.
קופונים על המנוי ועל פריטים בודדים מופחתים מה-MRR. קופון בסכום קבוע נספר רק במטבע שלו.
מנויים מושהים ולא משולמים נספרים כנטישה; מנוי שהתשלום שלו באיחור ממשיך להיספר בזמן ש-Stripe מנסה לחייב את הכרטיס שוב.
חיובים, החזרים ומחלוקות נספרים לפני מס, לפי חלק המס בחשבונית או ב-Checkout Session שלהם. בלי הרשאת קריאה ל-Checkout Sessions, המס על מכירות מחוץ לחשבונית נשאר כלול.
מחיר שכולל מס נספר ב-MRR לפני מס, לפי חלק המס בחשבונית האחרונה.
השהיית גביית התשלומים נספרת כנטישה מהיום שבו RevGlance רואה אותה לראשונה, כי Stripe לא מציינת לה תאריך.

באיך אנחנו סופרים מפורטים הכללים שחלים על כל ספק.

אימיילים לשחזור

שחזור מקשר תשלום מנוי שנכשל לעמוד החשבונית הפתוחה שלו ב-Stripe, שם הלקוח יכול לשלם עם כרטיס חדש. כשאין חשבונית פתוחה, הוא פותח במקום זאת סשן בפורטל הלקוחות של Stripe. החלופה הזו דורשת שהפורטל יופעל ב-Stripe ומפתח שמורשה לכתוב סשנים של Customer portal; בלעדיהם, האימייל מקשר לעמוד עדכון הכרטיס שלך.

פתרון בעיות

"יש להדביק מפתח סודי או מוגבל של Stripe." המפתח חייב להתחיל ב-rk_ או ב-sk_. מפתח שאפשר לפרסם (pk_) לא יכול לקרוא כלום.
"המפתח נדחה על ידי Stripe." המפתח בוטל, או שחסרה לו גישת קריאה ל-Balance.
"הבקשה לגבי החיוב שנכשל נדחתה על ידי Stripe" או "בקשת המנוי נדחתה על ידי Stripe": המפתח לא יכול לקרוא Charges או Subscriptions. התשלומים עדיין מסתנכרנים; להוסיף את ההרשאה החסרה ולסנכרן שוב.