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

# Webhooks

> Rails uses signed webhooks to notify integrators when settlement states change.

Rails uses webhooks to notify B2B integrators about settlement state changes.

## What webhooks are for

* order created
* order funded
* order settling
* order settled
* order failed
* order expired

## Integration rules

* Make webhook handlers idempotent
* Persist the last known event ID
* Reconcile webhook state against your own order table
* Treat retries as normal
* Treat webhooks as a settlement signal, not the only source of truth

## Operational rule

Never depend on a single webhook delivery to advance your business state.