Skip to main content
POST
Stripe webhook receiver
This endpoint receives webhook events from Stripe when payment-related events occur, such as successful charges, failed payments, and subscription updates.
This endpoint verifies the webhook signature using your Stripe webhook secret. Configure this URL in your Stripe Dashboard under Developers > Webhooks with the URL https://api.recurso.dev/webhooks/stripe.

Example Request

Stripe sends a POST request with event data:

Response

Returns 200 OK on successful processing.
If signature verification fails, the endpoint returns 400 Bad Request and the event is not processed. Ensure your Stripe webhook secret in Recurso matches the one configured in the Stripe Dashboard.

Authorizations

Authorization
string
header
required

Headers

Stripe-Signature
string
required

Stripe webhook signature header.

Body

application/json

Raw Stripe event payload.

Response

Event processed (or deliberately ignored).

status
enum<string>
Available options:
ok,
ignored
reason
string

Present when the event was ignored.