Skip to main content

Stripe

Category: Payments. Connect Stripe and your widget can answer billing questions and start purchases for visitors, right inside the chat.
Integrations are available on the Pro and Business plans.

What This Bot Can Do

The bot does exactly these actions, nothing more. “Needs sign-in” means the visitor must be identified first; otherwise the bot gives a safe, neutral answer.
ActionWhat it doesNeeds sign-in
Check a subscriptionShow the visitor their current plan and next billing date.Yes
Check invoice historyList the visitor’s recent invoices with amounts, dates, and payment status.Yes
Check payment methodsShow saved payment methods (card brand and last 4 digits only).Yes
Open the billing portalGive the visitor a secure portal link to cancel, upgrade, or update payment themselves.Yes
Start a purchaseGenerate a checkout link so the visitor can buy a plan or product.No

What It Can’t Do

Stripe is scoped to the actions above. It does not:
  • Cancel or change a subscription directly (it hands the visitor a secure portal link instead)
  • Issue refunds or charge a card
  • Create or edit products and prices
  • Show full card numbers (only the brand and last 4 digits)

How to Connect

BestChatBot connects to Stripe with a restricted API key — a key scoped to only the permissions the bot needs. You create the key in your Stripe Dashboard, then paste it into BestChatBot.

Step 1 — Create a restricted key in Stripe

In your Stripe Dashboard, go to Developers → API keys and click Create restricted key.
Stripe Dashboard API keys page with the Create restricted key button
When asked how you’ll use the key, choose Providing this key to a third-party application.
Stripe asking how the key will be used, with third-party application selected
Enter the website details — give the key a recognizable Name (e.g., “Bestchatbot Stripe Integration”) and your site URL — then check Customise permissions for this key.
Stripe Enter website details form with name, URL, and Customise permissions checked

Step 2 — Grant the right permissions

Set exactly these permissions, and leave everything else as None:
Stripe resourcePermission
Customer PortalWrite
InvoicesRead
PricesRead
SubscriptionsRead
Checkout SessionsWrite
Stripe permissions list with Customer Portal Write, Invoices Read, Prices Read, Subscriptions Read, Checkout Sessions Write
Create the key and copy it. It looks like rk_live_....
Grant only the permissions above. A key with more access than the bot needs is an unnecessary risk. The restricted key is read-only except for the billing portal and checkout links it generates for the visitor.

Step 3 — Connect in BestChatBot

In your workspace dashboard, open the Integrations tab, find Stripe, and click Connect. A secure popup opens:
  • Paste your Restricted API Key into the key field.
  • Leave Stripe Context empty — you don’t need it.
Click Connect. Your credentials go straight to the secure form, never into the chat.
BestChatBot Stripe connection popup showing the Restricted API Key field and an empty Stripe Context field
Connecting integrations requires an Editor, Admin, or Owner role. See Members & Roles.

Step 4 — You’re connected

Once connected, Stripe’s actions become available to your widget right away. From the integration panel you can toggle each bot capability (check subscription, invoice history, payment methods, manage subscription, create checkout) and set optional Checkout redirect URLs:
  • Success URL — where the visitor lands after a completed payment.
  • Cancel URL — where the visitor lands if they cancel.
If you leave them empty, the visitor returns to your widget’s base domain.
Connected Stripe panel showing bot capability toggles and checkout redirect URL fields

Showing Products in Checkout

When the bot offers Start a purchase, it only shows the products you’ve explicitly opted in — your full Stripe catalog is never exposed. To make a product available, add the metadata key bcb_widget_visible with the value true to the product (or to a specific price) in Stripe.
Stripe product metadata showing bcb_widget_visible set to true
Set the flag on the product to expose all of its prices, or on a single price for finer control. Products without this flag never appear in the chat.

See It in Action

Once connected, identified visitors can check invoices, view saved payment methods, manage their subscription, and start a purchase — all from the widget.
Live widget showing invoices, saved payment methods, and subscription quick actions

One per Category

Stripe is the only option in the Payments category, so it never conflicts with another integration.

Availability

PlanStripe
Free
Starter
Pro
Business

Next Steps

All Integrations

See the full catalog and how categories work.

Agentic Actions

Learn how the bot turns a request into a real action.