Connect Stripe
A step-by-step guide with pictures, from the Speakvora agent's own Connect tab.
Short answer: GOAL: your agent hears about failed payments, upcoming invoices, refunds and paid checkouts. TIME: about 10 minutes. COST: free. YOU NEED: your agent running with a public address (Connect, Permanent address) and sign-in to Stripe as the owner or an admin.
Every key, number and name in the pictures is a made-up example. Nothing here asks you to share a real key with anyone but the app on your own computer.
GOAL: your agent hears about failed payments, upcoming invoices, refunds and paid checkouts. TIME: about 10 minutes. COST: free. YOU NEED: your agent running with a public address (Connect, Permanent address) and sign-in to Stripe as the owner or an admin.
TIP: You can't break anything. A webhook is only a message Stripe sends. You can delete it and start again.
Part 1. Open the Connect tab in your agent
- Open your agent's dashboard (the page you open from the Start Speakvora Agent file).
- Press Connect in the menu. On a phone the menu is the bar along the top; slide it sideways if you do not see Connect.
- Under Your apps type stripe in the box that says Find an app (1), or scroll down the list, and press it. A card slides up.
- The card shows an address (it ends in /event) and a secret. Press Copy next to each. Keep the page open.


Part 2. Add it in Stripe
- In Stripe open [[Developers > Webhooks > Add endpoint]].
- Endpoint URL: paste the agent's address.
- Select events: invoice.payment_failed, invoice.upcoming, charge.refunded and checkout.session.completed. For invoice follow-up (optional) also add invoice.created, invoice.overdue and invoice.paid.
- Press Add endpoint. On the endpoint's page reveal the Signing secret (it starts with whsec_) and copy it.
- Paste it into the agent card and press Save and test.
WARNING: The secret is private. It proves to your agent that a message really came from Stripe.
Part 3. Test it
- Press Save and test on the card (paste the secret first if the card asks you to).
YOU SHOULD SEE: green words saying Connected. Use Stripe's Send test webhook button on the endpoint and it appears in Activity.
If something is wrong
- Stripe shows the endpoint as failing: the agent's address is wrong or the computer is off. Open the endpoint and press Resend after fixing it.
- Bad signature in Activity: paste the signing secret again.
All help guides · Every agent feature · AI receptionist by industry
Questions
What if this happens: Stripe shows the endpoint as failing?
the agent's address is wrong or the computer is off. Open the endpoint and press Resend after fixing it.
What if this happens: Bad signature in Activity?
paste the signing secret again.