Add an endpoint
Dashboard → Webhooks → add your HTTPS URL and choose events (start withpayment.confirmed). You’ll get a signing secret (whsec_…).
Payload
Verify the signature
Always verify before trusting anything:Events
wallet.* and bridge.* payloads include walletId/bridgeTransferId,
chain/route, amount, and the relevant transaction hash(es) — shaped
the same way as their API responses in Wallets and
Bridge.
Delivery & retries
- Respond
2xxwithin 10 seconds; anything else counts as a failure. - We retry up to 3 times with backoff; deliveries and status codes are visible in the dashboard.
- Handlers must be idempotent — key on
paymentIntentId.