תיעוד

Stripe

קריאת ההכנסות, ה-MRR והמנויים שלכם ב-Stripe מתוך pipeline, ויצירת קישורי תשלום.

האינטגרציה Stripe מעניקה ל-pipelines שלכם קריאה של הפעילות שלכם ב-Stripe — ואת היכולת לגבות באמצעות קישורי תשלום. זהו חשבון ה-Stripe שלכם: betool קוראת את הנתונים שלכם, אינה ניצבת בתוך תזרימי הכספים ואינה גובה שום רווח.

מה אפשר לעשות עם זה

  • לעקוב אחר ההכנסות שלכם — הכנסה שנגבתה בתקופה, MRR, מנויים פעילים, מנויים חדשים, ביטולים, מספר לקוחות.
  • להזין סוכן ניהולי — לדוגמה סוכן שמסכם את הפיננסים של השבוע (ראו תרחישי שימוש → CFO IA).
  • לגבות מתוך סוכן — ליצור קישור תשלום Stripe Checkout ולבדוק את הסטטוס שלו (ראו פעולות ללא קוד).

חיבור (BYO)

  1. הגדרות → שירותים → Stripe, לשונית חשבונות, ואז + חשבון חדש.
  2. הזינו תווית, את המצב (test או live) ואת מפתח ה-API שלכם ב-Stripe. ממשק הניהול ממליץ על מפתח מוגבל לקריאה בלבד (rk_live_… או rk_test_…) המורשה על Balance, Charges, Customers ו-Subscriptions; כדי ליצור קישורי תשלום, המפתח צריך גם להיות מסוגל ליצור sessions של Checkout.
  3. המפתח מאוחסן בצד השרת ולעולם אינו מוצג שוב: הקריאות של API הניהול חושפות רק מחוון has_secret_key.

ריבוי חשבונות. ארגון יכול לחבר מספר חשבונות Stripe (לדוגמה שתי ישויות משפטיות). חשבון מסומן כברירת מחדל; הצומת מכוון לחשבון מסוים באמצעות account_id, ה-tools באמצעות הפרמטר account שלהם (תווית או מזהה).

הצומת stripe_report

מקמו צומת stripe_report ב-pipeline כדי לאחזר תמונת מצב של הפעילות שלכם: revenue, mrr, active_subs, new_subs, churned_subs, customers, עם currency, period ו-since. אתם בוחרים את המדדים (אף אחד לא מסומן = כולם) ואת החלון (24h, 7d, 30d, 90d, החודש הנוכחי, השנה הנוכחית). הסכומים מוחזרים ביחידה הראשית של המטבע (לדוגמה אירו, לא סנטים). הפלט שלו מתפרסם להקשר וניתן לצריכה על ידי סוכן בהמשך הזרם, שמנסח אותו מחדש.

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

Tools של סוכן

  • קריאה: stripe.report (אותם מדדים כמו הצומת), stripe.list_customers, stripe.get_subscription, stripe.check_payment.
  • כתיבה: stripe.create_payment_link.

קישורי תשלום

סוכן יכול ליצור קישור תשלום Stripe Checkout (stripe.create_payment_link) ולבדוק לאחר מכן אם התשלום התקבל (stripe.check_payment). שימוש טיפוסי: לגרום ללקוח לשלם מראש עבור פגישה לפני אישורה. פירוט ה-tools בפעולות ללא קוד.

אבטחה ועלויות

  • הקריאה מתוחמת לארגון שלכם; נתוני ה-Stripe שלכם לעולם אינם נראים על ידי ארגון אחר.
  • אין metering של betool על קריאות אלו — אתם משתמשים בחשבון שלכם עצמכם.