Skip to main content
Stripe Actions are Chatbase Actions that let your AI agent read and update a signed-in customer’s Stripe billing data during a conversation: their subscription, invoices, plan, and billing details. They’re built for subscription businesses that bill through Stripe, such as SaaS products and memberships, and they run in the chat bubble on your website. Stripe Actions enable your AI agent to handle customer billing inquiries, subscription management, and account updates directly within the chat interface. These Actions provide secure, real-time access to customer payment information, streamlining support operations and improving the customer experience.
Prerequisites: Before using Stripe Actions, you must:
  1. Set up the Stripe integration with your Chatbase account
  2. Configure identity verification for secure customer authentication
  3. Set up contacts with valid stripe_accounts entries for each customer

Available Stripe Actions

How Stripe Actions work

Stripe Actions use Chatbase’s identity verification system to securely access customer-specific data:
  1. User authentication: Customers are identified using window.chatbase("identify", {...}) with their unique user ID
  2. Contact matching: The system matches the authenticated user ID to a contact record containing their Stripe account ID
  3. Secure data access: Actions retrieve only the data associated with the authenticated customer’s Stripe account
  4. Real-time responses: The AI agent answers immediately using live Stripe data
Stripe Actions need an identified customer, so they don’t run in Action Preview or Compare. To test them in the Playground, start the conversation with Chat as user and set the User ID to a customer whose contact record has a valid stripe_accounts entry. To test the real thing end to end, embed the JavaScript script on your site and run the Action there.

Examples for subscription businesses

These examples show how the four Stripe Actions above can cover common billing conversations. Each one uses only the Actions on this page.
A customer asks, “What plan am I on, and did last month’s payment go through?” With Get subscription information and Get invoice history enabled, the AI agent shows the current plan, status, and renewal date, then lists recent invoices and their payment details. Both Actions only read data, so they’re a low-risk place to start.
A customer on your starter plan writes, “Upgrade my plan to the pro.” With Manage subscriptions enabled and your plans defined in its settings, the AI agent can show the available plans and move the customer to the one they choose. Test upgrades and downgrades for correct proration before going live.
A member says, “I need to cancel my subscription.” Configure the cancellation policy in Manage subscriptions, turn on Only use in Procedures, and call the Action from a Procedure that first checks what you need, such as the reason for leaving. The Procedure Templates tab includes ready-made flows for subscription cancellations and billing disputes that you can adapt.
A member who moved writes, “I need to update my billing address.” With Change billing information enabled, the AI agent updates the address on their Stripe customer record, and the change is reflected in Stripe.

How to create a Stripe Action

Every Stripe Action is created the same way. The Action sections below list only what differs: which Action to pick and any extra configuration it needs.
1

Navigate to Actions

Go to your Chatbase dashboard and select your AI agent. Click Build > Actions in the left sidebar.
2

Create the Action

Click Create Action, then on the Stripe card select the Action named in its section below.
3

Configure General Settings

Action Name: A unique, descriptive name for the Action.When to use: Detailed instructions for when the AI agent should use this Action.To restrict the Action to Procedure steps only, turn on Only use in Procedures. When it’s on, the When to use field is hidden, because the AI agent no longer decides when to call the Action.
4

Configure the Action's own settings

Manage subscriptions adds a step for defining the available plans and cancellation policy. Every other Action skips straight to channels.
5

Choose Channels

Stripe Actions are compatible with the Chat Bubble channel only. Every other channel is incompatible and can’t be selected. Use Channels to toggle the Action on or off for Chat Bubble, then click Save. See Channels for what configured, unconfigured, and incompatible mean.
6

Enable and Test

Ensure the Action is toggled to Enabled, then test it in the embedded widget on your site.

Actions

1. Get subscription information

Retrieve and display customer subscription details, including current plan, status, billing cycle, and pricing information.

Best for:

Answering questions about current subscription status, plan details, renewal dates, and subscription history.
Common Use Cases:
  • “What’s my current plan?”
  • “When does my subscription renew?”
  • “How much am I paying monthly?”
  • “Is my subscription active?”

Settings

Action: Stripe Get Subscription Info.
Selecting the get subscription Action from the Stripe options
Test the Action in the embedded widget to ensure it correctly retrieves subscription data for authenticated customers.
The AI agent returning subscription details in chat

2. Get invoice history

Retrieve and display customer invoice history, payment details, and billing records.

Best for:

Providing access to billing history, payment confirmations, invoice downloads, and payment troubleshooting.
Common Use Cases:
  • “Show me my recent invoices”
  • “Was my payment processed?”
  • “Can you provide my billing history?”

Settings

Action: Stripe Get Invoices.
Selecting the get invoices Action from the Stripe options
Test the Action with a sample customer request in the embedded widget.
The AI agent returning invoice history in chat

3. Manage subscriptions

Comprehensive subscription management, including plan changes, upgrades, downgrades, and cancellations.

Best for:

Complete subscription lifecycle management: plan changes, adding payment methods, and cancellation handling.
Common Use Cases:
  • “I want to upgrade my plan”
  • “Upgrade my plan to the pro”
  • “I need to cancel my subscription”
  • “What plans are available?”

Settings

Action: Stripe → Manage Subscriptions.
Configuring the subscription management Action

Define available plans and cancellations

Manage subscriptions has four sections: General, Subscriptions, Cancellation, and Channels. Plans and cancellations are set in the middle two.
  • Customers can switch plans: let customers move to another plan.
  • Customers can change quantity of their plan: let customers change how many units they pay for.
  • Products: pick the products customers can choose from, with Minimum and Maximum quantity rules.
  • Prorate subscription updates: charge or credit the difference when a plan changes. Choose Invoice immediately or Issue invoice at the end of billing period.
The Subscriptions section of Manage subscriptions, with plan switching and product options
Test every scenario before going live: upgrading from basic to premium with proper proration, downgrading with the right billing adjustments, and the complete cancellation flow. All subscription changes should be immediately reflected in both Stripe and the customer experience.
The AI agent managing a subscription in chat
Manage subscriptions changes what a customer pays. Consider turning on Only use in Procedures and putting your eligibility checks in a Procedure ahead of the step that calls it, so plan changes and cancellations happen at a point you control.

4. Change billing information

Allow customers to update their billing address and other account information.

Best for:

Self-service billing updates, address changes, and other account information updates.
Common Use Cases:
  • “I need to update my billing address”
  • “Update my billing email address”
  • “Update my billing phone number”

Settings

Action: Stripe → Change customer information.
Selecting the change billing information Action
Test the Action with various scenarios to ensure only authenticated customers can make changes, and verify that billing updates are reflected in both Stripe and the customer’s account.
The AI agent updating billing information in chat

Limitations

  • Stripe Actions require an authenticated customer. Every Action reads or writes the signed-in customer’s own Stripe record, so identity verification must be configured and the customer must be identified.
  • Each customer needs a contact record with a valid stripe_accounts entry. Without it, the Action has no Stripe customer to act on.
  • In the Playground, they only run through Chat as user. Start the conversation with Chat as user and a User ID that matches a contact with a valid stripe_accounts entry. Action Preview and Compare can’t identify a customer, so the Actions don’t run there.

Troubleshooting

Possible causes:
  • The Action is disabled in the dashboard, or turned off for the channel
  • The customer is not properly authenticated
  • The contact record is missing or has an invalid stripe_accounts entry
  • The When to use description is too vague to match what the customer asked
Solutions:
  • Enable the Action and check its Channels step
  • Check your identity verification implementation
  • Validate that the contact record has a correct stripe_accounts entry
  • Rewrite When to use with the phrases customers actually type
Possible causes:
  • Invalid Stripe customer ID in the contact record
  • The Stripe account has no subscription or invoice data
  • Stripe API permissions are insufficient
  • Network connectivity issues
Solutions:
  • Verify the Stripe customer ID exists and is active
  • Check that the Stripe account has relevant data
  • Review the Stripe integration permissions
  • Test Stripe API connectivity directly
Possible causes:
  • User hash validation is failing
  • external_id doesn’t match user_id
  • The contact record is not found
  • Identity verification was never called
Solutions:
  • Verify hash generation matches the expected format
  • Ensure external_id exactly matches the authenticated user_id
  • Create a contact record for the customer
  • Implement the identity verification flow properly

Best Practices

Security First

Always validate customer identity before processing any billing-related request. Never allow unauthenticated access to financial data.

Testing Coverage

Test all Actions with various scenarios, edge cases, and error conditions before going live: in the Playground through Chat as user, then from your real site with the embed in place.

Keep High-Stakes Actions on Rails

Put plan changes and cancellations behind a Procedure with eligibility checks, so the AI agent doesn’t decide on its own when a customer qualifies.

Clear Action Triggers

Write specific When to use descriptions so the AI agent distinguishes a question about a plan from a request to change it.

Frequently asked questions

No. Stripe Actions are compatible with the Chat Bubble channel only. Every other channel is incompatible and can’t be selected.
Turn on Only use in Procedures for Manage subscriptions, then call it from a Procedure step after your eligibility checks. The AI agent then can’t decide on its own to run it.
The AI agent tells the customer it can’t complete the request. Check the Troubleshooting causes above, such as a missing stripe_accounts entry or insufficient Stripe permissions.
Yes. In Tests, Get subscription information and Get invoice history can run live against your connected Stripe account, because they only read data. Actions that change data, such as Manage subscriptions, can’t run live: they return a generic success, or the mock response you write. Tests run against your published AI agent, while the Playground uses your draft.
Connecting Stripe needs the Basic plan or higher. Stripe Actions count toward your plan’s Action limit: up to 8 Actions on Basic, 12 on Business, and a customizable limit on Enterprise. A reply that triggers an Action costs twice the model’s usual message credits. See Credit usage.