Webhooks
Retries & delivery
Backoff, resending and idempotency.
A delivery succeeds when your endpoint returns a 2xx within 10 seconds. Otherwise LokiPay retries with exponential backoff:
| Attempt | Delay before it |
|---|---|
| 1 | immediately (within ~5 s) |
| 2 | 15 s |
| 3 | 30 s |
| 4 | 1 min |
| 5 | 2 min |
| 6 | 4 min |
| 7 | 8 min |
| 8 | 16 min — then the delivery is marked FAILED |
- Failed deliveries show in Webhooks and the dashboard bell. Click one to see the payload, the last HTTP status and error, and press Retry now / Resend.
- Resending uses the same event
id, so an idempotent handler is safe. - If your app was down for longer, reconcile with GET /v1/intents/by-reference/:reference.