Connect Your Stripe Account
Link your own Stripe account with your publishable and secret keys so you can bill clients by card, and learn what disconnecting does.
Written By voiceaiwrapper
Last updated 19 days ago
To charge clients by card, you connect your own Stripe account to VoiceAIWrapper. Your clients then pay you directly through Stripe, and the webapp creates the products, subscriptions and usage charges in your account for you.
Connecting takes about 2 minutes. You need two API keys from your Stripe Dashboard.
Available on: plans that include Bill your clients with Stripe. Without it, clicking Connect Stripe shows an upgrade prompt.
Before you start
You'll need:
- A Stripe account that can take live payments. You can create one at https://stripe.com.
- Your publishable key and secret key. In the Stripe Dashboard, open Developers β API keys. Use the standard secret key, not a restricted key.
- Stripe Tax set up in your Stripe account. You can connect without it, but you can't create plans until it's done. See Tax Settings for Client Billing.
Your secret key gives full access to your Stripe account. Paste it only into the Connect Stripe dialog. Don't send it by email or chat, including to support. If you think it has leaked, roll the key in your Stripe Dashboard.
Step 1: Open the Integration tab
- In the sidebar, open Billing Configuration β Stripe.
- Open the Integration tab.
Until Stripe is connected, the card shows Not connected with a Disconnected badge, and the section below reads Tax settings, plans, packs & charges are locked.
Step 2: Paste your keys
- Click Connect Stripe.
- In Secret Key, paste your secret key (a live key starts with
sk_live_). - In Publishable Key, paste your publishable key (a live key starts with
pk_live_). - Click Connect.

VoiceAIWrapper checks the secret key with Stripe before saving it. When it works, you'll see Stripe account added successfully. At the same time, the webapp adds a webhook endpoint and a usage meter to your Stripe account. These are how it learns about payments and reports per-minute usage, so leave them in place.
Step 3: Check the connection
The card now shows Connected to Stripe with a green Connected badge, and your publishable key appears (masked) underneath. Click the eye icon to show it. The copy icon works once the key is showing. The secret key isn't displayed.

Below the connection card you'll now see Tax settings. If its badge says Needs attention, finish your tax setup before creating plans. See Tax Settings for Client Billing.
Step 4: Finish what Stripe billing needs
Connecting Stripe is one of two requirements for billing a client through Stripe. The other is a verified custom domain for your client portal, because clients pay and manage their subscription there. See Connect Your Custom Domain.
With both in place, you can:
- Create your plans. See Create a Billing Plan.
- Choose Stripe billing for a client. See Ways to Bill Your Clients: Stripe or External Billing.
Create and change your plans, usage packs and one-time charges in VoiceAIWrapper, never in the Stripe Dashboard. Editing those products in Stripe breaks the sync with VoiceAIWrapper and can break client billing.
Disconnect Stripe
Stripe must stay connected for client billing to work. Disconnect only if you're stopping Stripe billing altogether.
- Open Billing Configuration β Stripe β Integration.
- Click Disconnect.
- Tick Yes, disconnect Stripe, then click Disconnect.
What disconnecting removes can't be restored. Connecting again later starts from an empty setup. Disconnecting removes from VoiceAIWrapper:
- your Stripe products (plans, usage packs and one-time charges)
- subscription syncing and future updates between Stripe and VoiceAIWrapper
It also deletes the webhook endpoint it added in your Stripe account, and clears the billing method on every client billed through Stripe, so their Billing tab goes back to Choose how you'll bill this client.
Active subscriptions stay active in Stripe, and disconnecting doesn't cancel them. VoiceAIWrapper stops syncing them. Cancel any you no longer want in your Stripe Dashboard.
Troubleshooting
It says "Invalid secret key."
It says "Invalid secret key."
Stripe rejected the key. Copy the secret key again from Developers β API keys in your Stripe Dashboard, with no spaces before or after it. If you rolled the key recently, use the new one.
It says "Stripe key already in use."
It says "Stripe key already in use."
These keys are already connected to another VoiceAIWrapper organization. A Stripe account can be connected to one organization only. Disconnect it from the other organization first, or use a different Stripe account.
It says "Error connecting to Stripe" or the connection works but plans fail.
It says "Error connecting to Stripe" or the connection works but plans fail.
Check that you used the standard secret key, not a restricted key. The webapp creates products, customers, a webhook and a usage meter in your Stripe account, so the dialog asks for a key that isn't restricted.
Clicking "Connect Stripe" opens an upgrade prompt.
Clicking "Connect Stripe" opens an upgrade prompt.
Your plan doesn't include Bill your clients with Stripe. See A Feature Is Locked or Asks Me to Upgrade.
How do I change my Stripe keys or switch Stripe accounts?
How do I change my Stripe keys or switch Stripe accounts?
There's no separate update option on the Integration tab. Changing keys means disconnecting and connecting again, which removes your plans, packs and one-time charges from VoiceAIWrapper and clears the billing method on your Stripe-billed clients (see the warning above). If you have active client subscriptions, contact support through Need help? β Help Chat before you change anything.
Related articles
Was this helpful?
More in Billing Your Clients
Choose a Pricing ModelCreate a Billing PlanOffer Free Trials to ClientsBill Chat ConversationsStill need help? Share an idea