| Status family | Meaning | Typical action |
|---|---|---|
| created / pending | transfer accepted but not final | monitor |
| in_analysis | manual or provider review | keep queued |
| processing | work in flight | wait for webhook |
| transferred | completed successfully | mark payout settled |
| failed / rejected | unsuccessful | expose operator retry flow |
| canceled | intentionally stopped | close the request |
| unknown | external state not yet normalized | reconcile immediately |
The exact webhook event names are documented in Transfer Events.