Stripe
Connect Stripe to Era payments; customer Checkout and the recorded payment result are separate steps.
Connect Stripe to Era payments; customer Checkout and the recorded payment result are separate steps.
Where to use it
On the web, Settings → Apps → Installed apps (/settings/apps) manages connections; Apps (/apps) adds them. In Era Desktop: Business → Apps and Settings → Apps → Installed apps.
What you need
| Field | What to supply |
|---|---|
| Secret key | Required. Secret connection value. |
| Webhook signing secret | Required. Secret connection value. |
Connect step by step
Connect credentials
Fill in the connection form at Apps → Stripe; enter keys only in that form.
Open payment settings
Select the connected account in Settings → Payments (/settings/payments) and use test mode.
Configure the provider callback
Configure the webhook/callback path in the technical section at the provider.
Check the result
Check that a controlled test payment appears with its result in Finance, then save customer availability and ordering separately.
Era and workflow actions
These are actions declared by the existing workflow block. Select the connected account and each action’s target IDs; listing an action does not run it automatically.
Native payment settings use finance.configure_payment_app. Charge/refund status follows the provider’s verified result; connecting an account does not produce a payment event. See the Finance guide for available payment actions.
Triggers
| Trigger | When it starts |
|---|---|
stripe_webhook | Stripe workflow webhook delivery, configured separately from payment callbacks. |
Permissions and limits
Before connecting
The central app descriptor does not advertise Stripe tools to Era. The separate Stripe workflow block has payment, customer, subscription and invoice tools requiring an API key; do not assume the payment form’s secretKey is injected into that block. Track live charges through verified webhook results.
Apps read permission shows accounts; manage changes connections/settings; delete removes them. Inbox channel management needs Inbox manage, and payment settings need Finance manage. Workflows and Era also obey the target module’s permissions.
Related modules
Ask Era
Show Stripe payments from the Finance records.
Specify the account and target record. Era uses the connected account’s access and your role permissions; an example prompt is not a completed operation.
For technical teams
POST /api/pay/stripe/webhook is the payment provider callback path; workflow webhooks are separate. The workspace is resolved from the stored payment reference and the signature is verified using the connected account’s key.
Code sources: apps/studio/lib/integrations/definitions.ts, apps/studio/app/(app)/apps/components/connect-app.tsx, apps/studio/blocks/blocks/stripe.ts, packages/os-kernel/src/integrations/catalog.ts.