Документация

Stripe

Читайте вашу выручку, MRR и подписки Stripe из pipeline и генерируйте платёжные ссылки.

Интеграция Stripe даёт вашим pipeline возможность читать вашу активность в Stripe — а также принимать платежи через платёжные ссылки. Это ваш аккаунт Stripe: betool читает ваши данные, не встраивается в денежные потоки и не берёт наценки.

Что можно с этим делать

  • Отслеживать выручку — полученная выручка за период, MRR, активные подписки, новые подписки, отмены, число клиентов.
  • Питать управленческий agent — например, agent, который резюмирует финансы недели (см. Сценарии использования → CFO IA).
  • Принимать платежи из agent — генерировать платёжную ссылку Stripe Checkout и проверять её статус (см. No-code действия).

Подключение (BYO)

  1. Параметры → Сервисы → Stripe, вкладка Accounts, затем + Новая учётная запись.
  2. Укажите название, режим (test или live) и ваш API-ключ Stripe. Панель администрирования рекомендует ограниченный ключ только для чтения (rk_live_… или rk_test_…) с доступом к Balance, Charges, Customers и Subscriptions; для генерации платёжных ссылок ключ также должен уметь создавать сессии Checkout.
  3. Ключ хранится на стороне сервера и никогда не отображается повторно: чтения через административный API раскрывают лишь индикатор has_secret_key.

Несколько аккаунтов. Организация может подключить несколько аккаунтов Stripe (например, два юридических лица). Один аккаунт помечается как аккаунт по умолчанию; узел нацеливается на конкретный аккаунт через account_id, инструменты — через свой параметр account (название или идентификатор).

Узел stripe_report

Разместите узел stripe_report в pipeline, чтобы получить снимок вашей активности: revenue, mrr, active_subs, new_subs, churned_subs, customers, с currency, period и since. Вы выбираете метрики (ни одна не отмечена = все) и окно (24h, 7d, 30d, 90d, текущий месяц, текущий год). Суммы возвращаются в основной единице валюты (например, в евро, а не в центах). Его вывод публикуется в контекст и потребляется нижестоящим agent, который его переформулирует.

Рекомендуемый шаблон для управленческого показателя: пусть узел вычисляет агрегат, а agent только пишет прозу — детерминированный узел не может выдумать сумму.

Инструменты агента

  • Чтение: stripe.report (те же метрики, что и у узла), stripe.list_customers, stripe.get_subscription, stripe.check_payment.
  • Запись: stripe.create_payment_link.

Платёжные ссылки

Agent может сгенерировать платёжную ссылку Stripe Checkout (stripe.create_payment_link), а затем проверить, поступил ли платёж (stripe.check_payment). Типичное применение: получить предоплату за встречу перед её подтверждением. Подробности об инструментах — в No-code действиях.

Безопасность и стоимость

  • Чтение ограничено рамками вашей организации; ваши данные Stripe никогда не видны другой организации.
  • Никакого metering betool на этих вызовах — вы используете собственный аккаунт.