Create a new webhook
POST/api/v1/stores/:storeId/webhooks
Registers a webhook URL that Coinsnap will call whenever a selected invoice event occurs.
Available events
| Event | Triggered when |
|---|---|
New | Invoice created |
Processing | Payment received, awaiting confirmation |
Settled | Payment confirmed, payout sent |
Expired | Invoice expired before payment |
Coinsnap signs each delivery with an HMAC-SHA256 signature using the secret you provide.
Verify the X-Coinsnap-Sig header in your endpoint to confirm authenticity.
Tip: Omit
eventsto subscribe to all four event types.
Request
Responses
- 200
- 400
- 401
Successfully created the webhook
Bad request. Invalid input or unable to create the webhook.
Unauthorized.