Handling Failures and Retries
SettleSettle is designed for rock-solid reliability. We guarantee at-least-once delivery for webhook requests. If your server is offline or fails to respond with a successful HTTP status code, we retry delivery automatically.
Delivery Timeouts and Status#
Your endpoint must respond to a webhook POST request with a successful HTTP status code (2xx) within 10 seconds to signify successful processing.
If your server returns any non-2xx status (e.g. 500, 503, 404) or fails to respond within the 10-second timeout window, the delivery attempt is marked as failed.
Automatic Retry Protocol#
SettleSettle retries failed webhook deliveries up to 5 times in total.
- Attempt 1: Sent immediately when the event occurs.
- Attempt 2: Sent after
15 seconds - Attempt 3: Sent after
1 minute - Attempt 4: Sent after
5 minutes - Attempt 5: Sent after
15 minutes
If all 5 delivery attempts fail, the event is permanently recorded as failed. You can inspect the failure status codes, timestamps, and full response bodies at any time in the Deliveries History drawer within your App Settings panel.