betool betool

Documentation

Stripe

Lire vos revenus, MRR et abonnements Stripe depuis un pipeline, et générer des liens de paiement.

Stripe

L'intégration Stripe donne à vos pipelines une lecture de votre activité Stripe — et la capacité d'encaisser via des liens de paiement. C'est votre compte Stripe : betool lit vos données, ne s'interpose pas dans les flux d'argent et ne prélève aucune marge.

Ce que vous pouvez en faire

  • Suivre vos revenus — revenu encaissé sur une période, MRR, abonnements actifs, nouveaux abonnements, résiliations, nombre de clients.
  • Alimenter un agent de direction — par exemple un agent qui synthétise la finance de la semaine (voir Cas d'usage → CFO IA).
  • Encaisser depuis un agent — générer un lien de paiement Stripe Checkout et vérifier son statut (voir Actions sans code).

Connexion (BYO)

  1. Paramètres → Services → Stripe, onglet Comptes, puis + Nouveau compte.
  2. Renseignez un libellé, le mode (test ou live) et votre clé API Stripe. L'admin recommande une clé restreinte en lecture seule (rk_live_… ou rk_test_…) autorisée sur Balance, Charges, Customers et Subscriptions ; pour générer des liens de paiement, la clé doit aussi pouvoir créer des sessions Checkout.
  3. La clé est stockée côté serveur et n'est jamais réaffichée : les lectures de l'API d'administration n'exposent qu'un indicateur has_secret_key.

Multi-comptes. Une organisation peut connecter plusieurs comptes Stripe (ex. deux entités juridiques). Un compte est marqué par défaut ; le nœud cible un compte précis via account_id, les tools via leur paramètre account (libellé ou identifiant).

Le nœud stripe_report

Placez un nœud stripe_report dans un pipeline pour récupérer un instantané de votre activité : revenue, mrr, active_subs, new_subs, churned_subs, customers, avec currency, period et since. Vous choisissez les métriques (aucune cochée = toutes) et la fenêtre (24h, 7d, 30d, 90d, mois en cours, année en cours). Les montants sont rendus dans l'unité principale de la devise (ex. euros, pas centimes). Sa sortie est publiée dans le contexte et consommable par un agent en aval, qui la reformule.

Pattern recommandé pour un chiffre directionnel : laisser le nœud calculer l'agrégat, l'agent ne fait que rédiger — un nœud déterministe ne peut pas halluciner un montant.

Tools d'agent

  • Lecture : stripe.report (les mêmes métriques que le nœud), stripe.list_customers, stripe.get_subscription, stripe.check_payment.
  • Écriture : stripe.create_payment_link.

Liens de paiement

Un agent peut générer un lien de paiement Stripe Checkout (stripe.create_payment_link) et vérifier ensuite si le paiement a été reçu (stripe.check_payment). Usage typique : faire prépayer un rendez-vous avant de le confirmer. Détail des tools dans Actions sans code.

Sécurité & coûts

  • Lecture scopée à votre organisation ; vos données Stripe ne sont jamais visibles par une autre org.
  • Aucun metering betool sur ces appels — vous utilisez votre propre compte.