Delivery Attempts and Retries

We understand any server can be degraded, unavailable, or outage under very rare circumstances. Xendit provides automatic and manual retry features to help you to reconcile webhook events after an incident has been resolved on your end. We also send out an email of your webhook health traffic/statistics periodically that you can subscribe to.

Automatic Retry

Webhook automatic retry feature is automatically activated for all users upon sign up. You can choose to disable/enable the feature in Webhook Settings

INFO

Auto-retry feature will automatically retry present and future events. Past failed events won’t be retried by auto-retry.

INFO

Auto-retry will not retry any event with URL Not Set and Timeout status. Learn more about these statuses here. Kindly use manual retry if you need to resend the webhook.

When automatic retry is on, any failed events will be automatically retry for 24h with exponential backoff interval. The table below shows detail of interval between retries:

Retry NumberInterval (relative to last retry)Interval (relative to original attempt)
115m15m
245m1h
32h3h
43h6h
56h12h
612h24h

For each event, you can check the next redelivery schedule in Webhook tab. See View Events page for further guidance.

Manual Retry

Xendit also provides manual resend feature via Webhook tab. This feature provides flexibility for users who want to cherry pick events that they want to retry.

INFO

A Developer user permission is required to resend event

To resend an event manually, simply visit the Webhook tab, find the event, and click Resend. Any resend activities will be recorded alongside the timestamp and user name. Historical deliveries can be seen in Event History by clicking the event detail

  • When a manual resend was triggered, the Source in Event History displays user name who resend the event
  • Source: Automatic indicates that the event was delivered or retried automatically by system

Custom Retry

Webhook Custom Retry helps you to resend many webhooks based on your desired filter. With this feature, Webhooks are able to be filtered by date, webhook status, or product type, then you are able to resend all the filtered webhooks at once.

Use case of this feature is when your service or URL is down, and you need to resend all failed webhooks within specific time range. Then you can resend via Custom Resend by selecting the period down time and FAILED status. After clicking Apply Filter, then you can see the number of webhooks and able to resend them.

INFO

The maximum webhook number that is able to be retried is 500. If the amount exceeds, we recommend adjusting the filter and resending the webhooks in multiple batches.

You can simply visit the feature in Webhook tab, and see Custom Resend in the corner of the page.

Failed Webhook Email Notification

Xendit will send an email every time there is a failed webhook event that will be sent to the email registered as business owner. This email notification allows you to monitor any failed webhook request that require your further attention as it may potentially disrupt your operations.

If you wish not to receive the email notification, you may send an email to fundamentals@xendit.co and state your message that you wish to stop receiving Failed Webhook Email Notification. Our team will get back to you soon within 1x24 hour.

Last Updated on 2023-12-20