betool

Documentazione

Stripe

Leggi i tuoi ricavi Stripe, l'MRR e gli abbonamenti da una pipeline e genera link di pagamento.

L'integrazione Stripe offre alle tue pipeline una lettura della tua attività Stripe — e la possibilità di incassare pagamenti tramite link di pagamento. È il tuo account Stripe: betool legge i tuoi dati, non si interpone nei flussi di denaro e non applica alcun margine.

Cosa puoi farci

  • Monitorare i tuoi ricavi — ricavi incassati in un periodo, MRR, abbonamenti attivi, nuovi abbonamenti, cancellazioni, numero di clienti.
  • Alimentare un agent direzionale — ad esempio un agent che sintetizza le finanze della settimana (consulta Casi d'uso → CFO IA).
  • Incassare pagamenti da un agent — genera un link di pagamento Stripe Checkout e verificane lo stato (consulta Azioni no-code).

Connessione (BYO)

  1. Impostazioni → Servizi → Stripe, scheda Account, poi + Nuovo account.
  2. Inserisci un'etichetta, la modalità (test o live) e la tua chiave API Stripe. Il pannello di amministrazione consiglia una chiave con restrizioni in sola lettura (rk_live_… o rk_test_…) autorizzata su Balance, Charges, Customers e Subscriptions; per generare link di pagamento, la chiave deve anche poter creare sessioni Checkout.
  3. La chiave è archiviata lato server e non viene mai più mostrata: le letture dell'API di amministrazione espongono solo un indicatore has_secret_key.

Multi-account. Un'organizzazione può collegare più account Stripe (ad es. due entità giuridiche). Un account è contrassegnato come predefinito; il nodo si indirizza a un account specifico tramite account_id, gli strumenti tramite il loro parametro account (etichetta o identificativo).

Il nodo stripe_report

Inserisci un nodo stripe_report in una pipeline per recuperare un'istantanea della tua attività: revenue, mrr, active_subs, new_subs, churned_subs, customers, con currency, period e since. Scegli le metriche (nessuna selezionata = tutte) e la finestra (24h, 7d, 30d, 90d, mese corrente, anno corrente). Gli importi sono espressi nell'unità principale della valuta (ad es. euro, non centesimi). Il suo output viene pubblicato nel contesto ed è consumabile da un agent a valle, che lo riformula.

Pattern consigliato per una cifra destinata alla direzione: lascia che sia il nodo a calcolare l'aggregato e che l'agent si limiti a redigere il testo — un nodo deterministico non può inventare un importo.

Strumenti dell'agent

  • Lettura: stripe.report (le stesse metriche del nodo), stripe.list_customers, stripe.get_subscription, stripe.check_payment.
  • Scrittura: stripe.create_payment_link.

Un agent può generare un link di pagamento Stripe Checkout (stripe.create_payment_link) e poi verificare se il pagamento è stato ricevuto (stripe.check_payment). Uso tipico: far pagare in anticipo un appuntamento prima di confermarlo. Dettagli sugli strumenti in Azioni no-code.

Sicurezza e costi

  • Le letture sono circoscritte alla tua organizzazione; i tuoi dati Stripe non sono mai visibili a un'altra organizzazione.
  • Nessun metering betool su queste chiamate — stai usando il tuo stesso account.