English
API ReferenceSign In

Delivery Attempts and Retries

Last updated 06/10/2021

We understand any server can went 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 Callback Settings

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

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 Callback tab. See View Events page for further guidance

Manual Retry

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

A Developer user permission is required to resend event

To resend an event manually, simply visit the Callback 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

Periodic Email Notification

Xendit provides webhook summary via email every 6h that you can subscribe to. Email notification allows you to monitor your webhook traffic periodically on top of your monitoring system.

To enable this feature, users can visit their Email Recipient setting and enable Callback email reports. You can also unsubscribe from the email anytime by unticking the feature.