Developer documentation
Retries
Transport failure, provider rejection, rate limiting, and unknown external outcome are not the same class of failure and must not share one generic retry loop.
Implementation guide
What the integration should preserve.
- 01
Back off retryable transport and capacity failures.
- 02
Do not retry validation or authorization failures unchanged.
- 03
Reuse the same idempotency key for the same operation.
- 04
Stop blind retries when an external effect may already exist.
- 05
Move unknown outcomes into reconciliation.
Continue reading