Retries & Idempotency

Max attempts: 3 (initial send + up to 2 retries)
Delay between attempts: 60 seconds via delay queue
Success criteria: HTTP 200/201/202

Delivery behavior

We POST to your callback URL and treat HTTP 200/201/202 as delivered.
On non-2xx or network/timeout errors, we retry after a short delay, up to a small maximum number of attempts.
After the maximum is reached, we stop retrying.

Your responsibility: Always return a 2xx once you’ve safely persisted the event.

Webhooks may arrive more than once (e.g., retries, network jitter). Implement idempotency using any of:

Dedup key: payment_uuid (primary) and/or transaction_reference (your client_reference).
Upsert logic keyed by payment_uuid, updating status if it changes.
Exactly-once side effects: persist first, enqueue internal work, then return 2xx.

See Webhook payload for the full field list.

⌘I