> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liquidramp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Callbacks

> Outbound webhooks for order lifecycle events.

Liquidramp delivers **outbound webhooks** to your server when order lifecycle events occur. Configure the URL and subscribed events in the [partner portal](https://dashboard.liquidramp.com).

## 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

```json theme={null}
{
  "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

1. Verify signature before processing ([Webhook verification](/guides/webhook-verification))
2. Respond `2xx` quickly; process asynchronously
3. Deduplicate by `event` + `data.reference`
4. Fetch order detail when you need `payin` / `payout`

## Related

* [Webhooks quickstart](/quickstarts/webhooks)
* [Webhook verification](/guides/webhook-verification)
* [Order lifecycle](/concepts/order-lifecycle)