event_category field that indicates the type of event. Categories
are intentionally simple - they only indicate whether an object was created or updated. To
get the full object state, fetch it from the relevant API endpoint. This avoids issues with
concurrent or out-of-order notifications.
Webhook Delivery
Webhook delivery is considered successful on a2xx or 4xx response.
5xx responses are retried with exponential backoff up to 8 times.
Your webhook handler should return a successful response as soon as possible,
ideally immediately passing the event to an event queue or concurrent worker.
Event Categories
| Event | Description |
|---|---|
deposit.created | A fiat deposit has been initiated |
deposit.updated | A fiat deposit status changed (e.g. completed, failed) |
inbound_transfer.created | A stablecoin deposit was received on-chain |
payout.created | An on-chain payout transfer was initiated |
payout.updated | A payout transfer status changed |
withdrawal.created | A fiat withdrawal (off-ramp) was initiated |
withdrawal.updated | A fiat withdrawal status changed |
recipient.created | A new recipient was created |
recipient.updated | A recipient was updated |