Retries & ordering
Deliveries that do not receive a 2xx response are retried with exponential backoff for up to three days.
Retry schedule
| Attempt | Delay after previous attempt |
|---|---|
| 1 | Immediate |
| 2 | 1 minute |
| 3 | 5 minutes |
| 4 | 30 minutes |
| 5 | 2 hours |
| 6 | 8 hours |
| 7–12 | Every 12 hours until 72 hours have elapsed |
An endpoint that fails every delivery for 72 hours is disabled and webhook_endpoint.disabled is sent to your other endpoints and by email.
Timeouts
Your endpoint must respond within 10 seconds. Acknowledge quickly and process asynchronously.
Ordering
Events are sent in order on first attempt, but retries can deliver an older event after a newer one. Use created_at and fetch the resource with GET when the order matters.
Redelivery
curl -X POST https://api.neofin.tech/v1/events/ev_5Tq81/redeliver \
-H "Authorization: Bearer $NEO_API_KEY"
Events can be listed with GET /events?type=credit.settled&created_after=… and redelivered individually for 30 days.