يمنح تكامل Stripe الـ pipelines الخاصة بك قراءة لنشاطك على Stripe — إضافةً إلى إمكانية تحصيل المدفوعات عبر روابط الدفع. إنه حساب Stripe الخاص بك: تقرأ betool بياناتك، ولا تتدخّل في تدفّقات الأموال، ولا تأخذ أيّ هامش.
ما الذي يمكنك فعله به
- تتبّع إيراداتك — الإيراد المُحصَّل خلال فترة، و MRR، والاشتراكات النشطة، والاشتراكات الجديدة، والإلغاءات، وعدد العملاء.
- تغذية وكيل قيادي — مثلاً وكيل يلخّص ماليّات الأسبوع (راجع حالات الاستخدام ← CFO IA).
- تحصيل المدفوعات من وكيل — إنشاء رابط دفع Stripe Checkout والتحقّق من حالته (راجع إجراءات بلا كود).
الربط (BYO)
- الإعدادات ← الخدمات ← Stripe، تبويب الحسابات، ثم + حساب جديد.
- أدخل تسمية، والوضع (test أو live) ومفتاح Stripe API الخاص بك. توصي لوحة الإدارة بـمفتاح مقيَّد للقراءة فقط (
rk_live_…أوrk_test_…) مُصرَّح له على Balance و Charges و Customers و Subscriptions؛ ولإنشاء روابط دفع، يجب أن يتمكّن المفتاح أيضاً من إنشاء جلسات Checkout. - يُخزَّن المفتاح على جانب الخادم ولا يُعرَض مجدّداً أبداً: لا تكشف قراءات واجهة برمجة تطبيقات الإدارة سوى مؤشّر
has_secret_key.
تعدّد الحسابات. يمكن للمؤسسة ربط عدّة حسابات Stripe (مثل كيانين قانونيين). يُعلَّم أحد الحسابات بوصفه الافتراضي؛ وتستهدف الـ node حساباً محدّداً عبر account_id، والأدوات عبر مُعامِلها account (التسمية أو المُعرِّف).
node بـ stripe_report
ضع node بـ stripe_report في pipeline لجلب لقطة من نشاطك: revenue، mrr، active_subs، new_subs، churned_subs، customers، مع currency وperiod وsince. تختار المقاييس (عدم تحديد أيّ منها = جميعها) والنافذة (24h، 7d، 30d، 90d، الشهر الجاري، السنة الجارية). تُعرَض المبالغ بالوحدة الرئيسية للعملة (مثلاً اليورو، لا السنتات). يُنشَر مُخرَجه في السياق ويكون قابلاً للاستهلاك من قِبل وكيل agent لاحق يعيد صياغته.
النمط الموصى به لرقم موجّه للقيادة: دع الـ node يحسب المُجمَّع، واجعل الـ وكيل يكتب النثر فقط — فالـ node الحتمي لا يمكن أن يهلوس مبلغاً.
أدوات الوكيل
- القراءة:
stripe.report(المقاييس نفسها التي تحسبها الـ node)،stripe.list_customers،stripe.get_subscription،stripe.check_payment. - الكتابة:
stripe.create_payment_link.
روابط الدفع
يمكن لوكيل agent إنشاء رابط دفع Stripe Checkout (stripe.create_payment_link) ثم التحقّق ممّا إذا كان الدفع قد وصل (stripe.check_payment). الاستخدام النموذجي: جعل الموعد مدفوعاً مسبقاً قبل تأكيده. تفاصيل الأداة في إجراءات بلا كود.
الأمان والتكاليف
- عمليات القراءة محصورة بنطاق مؤسستك؛ ولا تظهر بيانات Stripe الخاصة بك لمؤسسة أخرى.
- لا احتساب استهلاك (metering) من betool على هذه الاستدعاءات — فأنت تستخدم حسابك الخاص.