Skip to main content

Add an endpoint

Dashboard → Webhooks → add your HTTPS URL and choose events (start with payment.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 2xx within 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.