Skip to main content

Webhooks

SDK webhooks notify your backend when server-side borrow workflow milestones happen. The first supported event is fired when the BTC deposit is confirmed during the SDK lending workflow.

Configure an endpoint

Webhook settings are scoped to the API key used by the SDK request.
Rotate the signing secret before accepting production traffic:
Store the returned secret securely. It is only returned in the rotation response.

Event

sdk.borrow.btc_deposit_confirmed

Sent after the SDK lending workflow confirms the BTC bridge deposit and receives the bridge redeem transaction hash.

Verify signatures

Each webhook request includes: Signatures are HMAC-SHA256 over ${timestamp}.${rawBody} using your webhook secret.