Appearance
Stripe
Stripe is how your customers pay you. This is your Stripe account, separate from the one that bills you for your subscription.
Setup walkthrough: payments. This page is the reference.
The two connection methods
Stripe Connect Standard
Connect with Stripe creates a connected account on the platform Stripe and takes you through Stripe's own onboarding via an account link. On return, the account id and its state are stored.
What is stored on our side is the account id and whether charges are enabled. Your business details and bank account live with Stripe.
Disconnecting removes the stored link only. It never touches or closes your Stripe account.
Your own API keys
| Field | Where to find it |
|---|---|
Secret key (sk_...) | Stripe dashboard, Developers, API keys |
Publishable key (pk_...) | Same page |
Webhook signing secret (whsec_...) | Developers, Webhooks, after adding the endpoint |
Pasted keys take precedence over a Connect link if both exist.
Webhooks
Payment confirmation comes from a webhook, not from the customer's browser. Without it, a customer can pay and the invoice keeps showing unpaid.
| Connection | Webhook setup |
|---|---|
| Stripe Connect | Handled for you. One platform endpoint receives events for all connected accounts, verified with its own signing secret and resolved back to your workspace by the event's account field |
| Own keys | Add the endpoint in your Stripe dashboard, pointed at /webhooks/stripe on your workspace host, and paste the signing secret into the Stripe card |
All incoming webhooks are signature-verified and de-duplicated, so a replayed event does not double-record a payment.
What Stripe enables
| Feature | Without Stripe |
|---|---|
| Hosted pay link on invoices | Not available |
| Payments recorded automatically | Record them manually |
| Deposit checkouts on quotes | Not available |
| Card capture after a store or campaign checkout | Not available |
| Invoicing, PDFs, reminders | Still work |
A bank-transfer-only shop can run without Stripe. Put your bank details in the invoice template's payment instructions and record payments by hand.
Testing
Use test keys (sk_test_...) and click the whole path: invoice, pay link, payment, invoice flips to paid on its own. Then switch to live keys and do one real low-value payment to yourself before invoicing a customer.
Troubleshooting
| Symptom | Cause |
|---|---|
| Customer paid, invoice still unpaid | Webhook not arriving or not verifying. Check the endpoint and the signing secret |
| Pay link missing on an invoice | Stripe not connected, or charges not enabled on the connected account |
| Card declined for a specific customer | Stripe's own decline reason, visible in your Stripe dashboard |
| Everything worked in test, fails live | Test keys still saved, or live webhook endpoint not added |