Webhooks
Register a URL, get notified when things happen. HMAC-SHA256 signed. At-least-once delivery.Register
Event Types
| Event | When |
|---|---|
session.created | New session created |
payment.pending | Payment detected, confirming |
payment.routing | Cross-chain routing in progress |
payment.settled | Money arrived in recipient wallet |
payment.failed | Execution failed, auto-refund started |
session.expired | Session timed out |
deposit.detected | Deposit seen on-chain |
refund.created | Refund initiated |
refund.settled | Refund completed |
refund.failed | Refund failed |
dispute.flagged | Dispute raised on a payment |
dispute.resolved | Dispute resolved |
Payload Format
Signature Verification
Retry Policy
5 retries with exponential backoff:| Attempt | Delay |
|---|---|
| 1 | Immediate |
| 2 | 1 second |
| 3 | 5 seconds |
| 4 | 30 seconds |
| 5 | 2 minutes |
exhausted.
Management
| Action | Endpoint |
|---|---|
| Update URL | POST /v2/webhooks/:id/url |
| Rotate secret | POST /v2/webhooks/:id/rotate-secret |
| Delete | DELETE /v2/webhooks/:id |
| View events | GET /v2/webhooks/:id/events |