Developer documentation

Webhooks and errors

Handle courier events quickly and retry safely.

Webhooks and errors

Courier callbacks should acknowledge quickly after the raw event is persisted. Status mapping and notification work happen after that boundary so provider retries do not create duplicate work.

Error behavior

Treat 400 as an input problem, 402 as a billing lock, 404 as a missing resource, and 429 as a retryable cooldown. When a response includes Retry-After, respect it before attempting another courier sync.

Keep webhook credentials and raw customer data out of application logs.