1я╕ПтГг How Webhook Responses Are Treated
When we send a webhook to your server, your system responds with an HTTP status code.
We classify responses like this:
тЬЕ 2XX (Success)
Example: 200, 201
This means your server received the webhook successfully.
ЁЯСЙ No retry is needed.
тЭМ 4XX or 5XX (Error)
Example: 400, 404, 500
This means something went wrong.
ЁЯСЙ The system will retry sending the webhook.
2я╕ПтГг How Retry Logic Works (Very Important)
If your webhook fails, we donтАЩt stop immediately.
We retry multiple times using increasing delay intervals.
HereтАЩs how it works:
Attempt | Delay Before Retry | Total Time Passed |
|---|---|---|
1st Retry | 30 seconds | 30 seconds |
2nd Retry | 1 minute | 1 minute 30 seconds |
3rd Retry | 5 minutes | 6 minutes 30 seconds |
4th Retry | 15 minutes | 21 minutes 30 seconds |
5th Retry | 30 minutes | 51 minutes 30 seconds |
тЬЕ Maximum retries: 5 attempts
If all 5 retries fail, the event is marked as Final Failed.
3я╕ПтГг When Does Auto-Pause Happen?
A webhook will be automatically paused ONLY if both conditions below are met:
тЬЕ Condition 1: Failure Rate Exceeds 2%
Failure Rate Formula:
(Final Failed Events ├╖ Total Events) ├Ч 100Example:
Total webhook requests = 11
Final failed events = 3
Failure rate = 27.27%
Since 27.27% is more than 2%,
ЁЯСЙ The webhook will be paused.
тЬЕ Condition 2: Minimum 10 Requests Required
Auto-pause will only be evaluated if:
Total requests тЙе 10
If fewer than 10 requests are received,
ЁЯСЙ Webhook will NOT be paused.
Important Clarifications
Please note the following:
Each webhook is monitored separately. (One webhook being paused does NOT affect others.)
Auto-pause is calculated only after all retries are completed.
Only final failed events are counted. (Retry failures are not counted individually.)
A single success after failures does NOT immediately reset the failure count.
Both total request count and failure count automatically reset after 48 hours. (Failure rate calculation starts fresh every 48 hours.)
Will You Receive Notification If Webhook Is Paused?
Currently:
YES email notification is sent.
This feature will be implemented soon.
You can check webhook status by:
ЁЯСЙ Going to your client panel
ЁЯСЙ Open Webhook Configuration
ЁЯСЙ You will see pause status and reason there
Best Practices to Avoid Auto-Pause
To prevent your webhook from getting paused:
Always return HTTP 200 for successful processing.
Make sure your server responds quickly.
Avoid returning 4XX or 5XX errors.
Ensure your server has enough capacity to handle webhook load.