Callbacks - Liquidramp

Liquidramp delivers outbound webhooks to your server when order lifecycle events occur. Configure the URL and subscribed events in the partner portal.

Event types

Event	Typical trigger
`order.created`	Order created, pay-in pending
`order.assigned`	Liquidity assigned
`order.asset_locked`	Crypto locked in escrow
`order.fiat_recieved`	Fiat pay-in confirmed
`order.asset_released`	Crypto released to recipient
`order.asset_refunded`	Crypto refunded on-chain
`order.fiat_sent`	Fiat payout initiated
`order.settled`	Order fully settled
`order.cancelled`	Order cancelled
`order.expired`	Pay-in window elapsed

Payload shape

{
  "event": "order.created",
  "data": { }
}

data is the summary order shape (same as list orders). It does not include payin or payout. Fetch GET /v1/orders/:reference for full detail.

Delivery

HMAC-signed with liquidramp-signature and liquidramp-timestamp
Failed deliveries retry with backoff
Delivery logs are available in the portal

Handler checklist

Verify signature before processing (Webhook verification)
Respond 2xx quickly; process asynchronously
Deduplicate by event + data.reference
Fetch order detail when you need payin / payout