← Back to help
Stripe — what the bot can answer
Once Stripe is connected, the bot can read everything that matters for finance and customer-success questions. All operations are read-only by default; write actions (refund, cancel) require the broader read_write scope and confirm with the user before firing.
The wordings below are examples, not commands. Ceven understands intent and context — say it however feels natural. "Who's our top customer?" and "tell me about the highest-grossing account this quarter" route to the same answer. References to "this month", "last quarter", "recently" are interpreted relative to today. The bot disambiguates when it's unsure rather than guessing.
Common questions to ask
what's our MRR right now?— sums active subscriptions normalized to monthly cadencehow many active subscriptions?show me our Stripe balance— available + pending, by currencylist our top customersany chargebacks or disputes?paid invoices this month— pulls invoice list with the right time filterwhat products are in our catalog?compare this month's revenue to last month
What's actually exposed
The Universal OAuth Plugin broker exposes 25 Stripe capabilities (read-only marked as R, write as W):
Subscriptions / MRR
- R
list_subscriptions— filter by status (active / past_due / canceled / all) - R
retrieve_subscription·list_subscription_items·list_subscription_schedules
Revenue / invoices
- R
list_invoices·retrieve_invoice·list_invoice_items
Cash / balance / payouts
- R
retrieve_balance·list_balance_transactions·list_payouts
Charges / payments / refunds / disputes
- R
list_charges·list_payment_intents·retrieve_payment_intent·list_refunds·list_disputes - W
create_payment_intent·create_refund
Customers / catalog
- R
list_customers·retrieve_customer·list_products·list_prices·retrieve_price
Connect platform
- R
list_application_fees
Subscription writes
- W
update_subscription·cancel_subscription
Connecting Stripe
- From Settings → Integrations, click Connect Stripe.
- Approve the OAuth flow. We use the standard Stripe Connect
read_writescope so all read endpoints are available; we never call write endpoints without an explicit confirmation in the chat. - Once connected, the bot's
act_on_providertool description automatically lists the new capabilities — no restart needed.
Test mode: if you're connecting a Stripe sandbox, the bot still works — but MRR / customers / invoices will all reflect test-mode data. To switch, disconnect & reconnect with the live-mode account.