Stripe setup
Point Stripe at your Hooks endpoint URL, choose the events you care about, and paste the signing secret so we can verify every payload.
Step 1: Sign in to Stripe Dashboard
Open dashboard.stripe.com and switch to the account that should send webhooks.
Step 2: Navigate to Webhooks
Go to Developers → Webhooks in the left sidebar.
Step 3: Add endpoint
Click Add endpoint. You will paste your Hooks URL in the next step.
Step 4: Paste your Hooks URL
In Hooks, open your Stripe endpoint setup page and copy the webhook URL (it looks like https://hooks.tinykomainu.com/in/stripe/…). Paste it as the endpoint URL in Stripe.
Step 5: Choose events
Select the events you want Hooks to receive. A common starting point is checkout.session.completed for new payments. You can add more events later.
Step 6: Copy the signing secret back to Hooks
After saving, Stripe shows a Signing secret starting with whsec_. Copy it and paste it into Hooks on your endpoint setup page. Hooks uses it to verify the Stripe-Signature header on every request.
Troubleshooting
Signature verification failed
The signing secret in Hooks must match the endpoint in Stripe exactly. If you roll the secret in Stripe, update Hooks too. Test mode and live mode use different secrets.
Events not arriving
- Confirm the endpoint URL in Stripe matches your Hooks URL character-for-character.
- Check Stripe's webhook delivery log for HTTP status codes (401 = bad signature).
- Make sure the endpoint is not paused in Hooks.
Dashboard shows no events
Trigger a test event from Stripe (e.g. send a test webhook for checkout.session.completed) or use Send test event in Hooks after the signing secret is saved.
{
"conditions": [
{ "field": "type", "op": "eq", "value": "checkout.session.completed" },
{ "field": "data.object.amount_total", "op": "gte", "value": 5000 }
]
}