betool

Dokumentation

Stripe

Lesen Sie Ihren Stripe-Umsatz, MRR und Ihre Abonnements aus einer Pipeline und generieren Sie Zahlungslinks.

Die Stripe-Integration verleiht Ihren Pipelines einen Lesezugriff auf Ihre Stripe-Aktivität — und die Möglichkeit, Zahlungen einzuziehen über Zahlungslinks. Es ist Ihr Stripe-Konto: betool liest Ihre Daten, schaltet sich nicht in die Geldflüsse ein und nimmt keine Marge.

Was Sie damit tun können

  • Verfolgen Sie Ihren Umsatz — über einen Zeitraum eingenommener Umsatz, MRR, aktive Abonnements, neue Abonnements, Kündigungen, Anzahl der Kunden.
  • Speisen Sie einen Führungsagenten — zum Beispiel einen Agenten, der die Finanzen der Woche zusammenfasst (siehe Anwendungsfälle → CFO IA).
  • Ziehen Sie Zahlungen über einen Agenten ein — generieren Sie einen Stripe-Checkout-Zahlungslink und verifizieren Sie seinen Status (siehe No-Code-Aktionen).

Verbindung (BYO)

  1. Einstellungen → Services → Stripe, Reiter Konten, dann + Neues Konto.
  2. Geben Sie eine Bezeichnung, den Modus (Test oder Live) und Ihren Stripe-API-Schlüssel ein. Das Administrationspanel empfiehlt einen eingeschränkten, schreibgeschützten Schlüssel (rk_live_… oder rk_test_…), berechtigt für Balance, Charges, Customers und Subscriptions; um Zahlungslinks zu generieren, muss der Schlüssel außerdem Checkout-Sitzungen erstellen dürfen.
  3. Der Schlüssel wird serverseitig gespeichert und nie wieder angezeigt: Lesezugriffe über die Administrations-API legen nur einen Indikator has_secret_key offen.

Mehrere Konten. Eine Organisation kann mehrere Stripe-Konten verbinden (z. B. zwei juristische Personen). Ein Konto wird als Standard markiert; der Knoten spricht ein bestimmtes Konto über account_id an, die Tools über ihren Parameter account (Bezeichnung oder Kennung).

Der Knoten stripe_report

Platzieren Sie einen Knoten stripe_report in einer Pipeline, um eine Momentaufnahme Ihrer Aktivität abzurufen: revenue, mrr, active_subs, new_subs, churned_subs, customers, mit currency, period und since. Sie wählen die Metriken (keine angehakt = alle) und das Zeitfenster (24h, 7d, 30d, 90d, laufender Monat, laufendes Jahr). Beträge werden in der Haupteinheit der Währung ausgegeben (z. B. Euro, nicht Cent). Seine Ausgabe wird in den Kontext veröffentlicht und ist von einem nachgelagerten Agenten konsumierbar, der sie umformuliert.

Empfohlenes Muster für eine an die Führung gerichtete Kennzahl: Lassen Sie den Knoten die Aggregation berechnen und den Agenten nur die Prosa schreiben — ein deterministischer Knoten kann keinen Betrag halluzinieren.

Agent-Tools

  • Lesen: stripe.report (dieselben Metriken wie der Knoten), stripe.list_customers, stripe.get_subscription, stripe.check_payment.
  • Schreiben: stripe.create_payment_link.

Ein Agent kann einen Stripe-Checkout-Zahlungslink generieren (stripe.create_payment_link) und dann verifizieren, ob die Zahlung eingegangen ist (stripe.check_payment). Typischer Einsatz: einen Termin vorab bezahlen lassen, bevor er bestätigt wird. Tool-Details in No-Code-Aktionen.

Sicherheit & Kosten

  • Lesevorgänge sind auf Ihre Organisation begrenzt; Ihre Stripe-Daten sind für keine andere Organisation sichtbar.
  • Kein betool-Metering auf diese Aufrufe — Sie nutzen Ihr eigenes Konto.