Webhooks resources

Webhooks deliver data to your client-side application about specific events happening within Recharge, for example:

• A subscription is created
• A customer account is created
• A subscription is canceled

Webhook use cases

Use webhooks to collect data from Recharge's API and create a variety of custom solutions. For example, build custom dashboards using webhook callback data to show information about customer purchases. See Webhook endpoints in the Recharge API documentation for more information.

Your application can be reactive to Recharge's webhooks and take follow-up actions like updating a subscription product when customers add it to cart.

Example workflow:

Your client offers a monthly subscription and wants to offer a rotating product every month.

Have your application listen for the order/created callback. You can then create a REST API call to change the product belonging to that subscription after your application receives the callback.

Webhooks explained

Handling the callback request

Callback payloads are identical to Recharge's REST API payloads.

For example, the callback for the subscription/created webhook is identical to the payload of a GET request to the subscriptions/<subscription_id> endpoint.

You should acknowledge you've received Recharge's webhook callback by sending a 200 OK response. If Recharge doesn't receive a response, or receives any response outside of the 200 range, Recharge will treat the payload delivery as a failure.

Webhooks retry

Recharge has a retry mechanism in place to cover any temporary webhook delivery failure.

The Recharge system attempts to send the same webhook 19 more times within the first 48 hours after the first failed submission. If the request fails each time or within this timeframe, the webhook is deleted from the Recharge system and is logged as a deleted webhook.

A notification is sent to the token owner for every failed attempt. On the 19th retry (the 20th attempt) the webhook is deleted entirely and a notification is sent to the owner of the related token.