Handling Failures and Retries

If your endpoint does not return 200 OK within 10 seconds, SettleSettle retries up to 5 times with exponential backoff (1m, 5m, 30m, 2h, 8h).

What this means:

• Your handler must be idempotent — processing the same event twice must not cause double credits or double payouts
• Use the providerReference field as your idempotency key
• Always return 200 even for event types you're not handling