Retry Policy
A delivery is successful when your endpoint answers any 2xx status within 15 seconds.
HTTP 200
{"received": true}Any 4xx, 5xx, timeout or connection failure schedules a retry:
| Attempt | When |
|---|---|
| 1 | immediately |
| 2 | +1 minute |
| 3 | +5 minutes |
| 4 | +15 minutes |
| 5 | +1 hour |
| 6 | +6 hours |
After the 6th failed attempt the delivery is marked failed. It stays visible in the Client Dashboard (Orders → order → Webhook deliveries) where you can Retry it manually; Boostigo staff can also retry it from the admin panel.
#Design for retries
- Deliveries can arrive more than once — de-duplicate on
X-Boostigo-Deliveryor on(order_id, status). - Respond fast; queue your own processing.
- If your endpoint is down for hours, reconcile with
GET /orders/{order_id}for any order stillprocessingon your side. - A permanently unreachable URL does not block orders — recharges continue regardless of webhook delivery.