Stripe Webhook Integration

Stripe webhooks are the most common webhook integration in Rails. Get them right: signature + timestamp verification, idempotency by event.id, handle the events you actually need (not every event in the catalog), retry safely.

The opinion

Use Stripe::Webhook.construct_event — signature + timestamp covered in one call. Persist a WebhookEvent for idempotency. Enqueue a job for actual processing. Handle only the events your business needs; ignore the rest. Separate test-mode and live-mode webhook secrets.

The event types you actually handle