USER GUIDE
Set up Stripe
Take card payments — plus Apple Pay, Google Pay and more — on your invoices' pay page.
Stripe is one of the two Card payments providers (the other is Authorize.Net) — only one of them can be switched on at a time. With Stripe on, a customer paying a shared invoice sees an embedded checkout for cards, plus wallet options such as Apple Pay and Google Pay where their device and browser support them.
What you need
A Stripe account (any country Stripe supports). From the Stripe dashboard's API keys page you'll need:
- Publishable key
- Secret key
Both come in a test and a live version — Stripe keeps them separate, so switch the mode in Bizinly to match whichever pair you paste in.
Where to paste them
In Bizinly, open Settings → Payments, and under Card payments pick Stripe from the provider dropdown. Set:
- Mode — Test mode or Live.
- Publishable key
- Secret key
- Webhook signing secret — see below.
Save the tab. Stripe is ready as soon as it's switched on with a secret key saved.
Test vs live mode
In test mode, Stripe's own test cards work and no money moves. Switch Mode to Live and paste your live publishable and secret keys once you're ready to accept real payments — Bizinly always calls the Stripe API that matches the mode you've selected.
The webhook
Stripe confirms a payment two ways: when the customer is brought back to the invoice after paying, and — more reliably, including if they close the tab before coming back — through a webhook. To register one:
- In the Stripe dashboard, add an endpoint pointed at:
https://<your-workspace-domain>/api/pay/stripe/webhook - Subscribe it to these events:
checkout.session.completed,checkout.session.async_payment_succeeded,checkout.session.async_payment_failed,checkout.session.expired. - Copy the endpoint's signing secret into Webhook signing secret in Bizinly and save.
Without a webhook registered, Bizinly still catches up on a paid session on its own within about an hour — the webhook simply makes confirmation instant.
Checking it works
With Stripe in test mode, open a test invoice's shared link, pay with one of Stripe's published test card numbers, and confirm the invoice moves to Paid with a payment recorded against it (method Stripe, referencing the Stripe payment). If you've registered the webhook, this happens the moment Stripe sends it, even before the browser redirects back.
Related: Online payments, Record and manage payments, Payment webhooks.