Webhooks
Stableyard delivers real-time webhook events when key actions occur.Event Types
| Event | Description |
|---|---|
payment.created | Payment order created |
payment.pending | Awaiting user action |
payment.completed | Payment settled successfully |
payment.failed | Payment failed |
account.created | Money Account registered |
vault.created | Safe-based vault deployed |
kyc.completed | KYC verification complete |
Webhook Payload
Verify Signatures
Always verify webhook signatures to ensure the request came from Stableyard.Best Practices
- Respond quickly: Return a 200 response within 5 seconds. Do async processing after acknowledging.
- Handle duplicates: Use the event
idto deduplicate. Stableyard may retry on failures. - Verify signatures: Always verify the
x-stableyard-signatureheader. - Log events: Store webhook payloads for debugging and auditing.
Retry Policy
If your endpoint returns a non-2xx status code, Stableyard will retry:- 1st retry: 1 minute
- 2nd retry: 5 minutes
- 3rd retry: 30 minutes
- 4th retry: 2 hours

