一、核心 Webhook 交互概览
入金流程中，平台与交易所通过以下 Webhook 实现实时同步：
settlement-update：法币到账后推送结算状态balance-update：用户法币余额变更时推送更新
二、流程与 Webhook 调用节点
1. 用户验证与准备阶段
- 若用户未完成 KYC，需引导其通过 KYC 流程开通法币交易权限
- 用户通过 KYC 后，可查看 Legend 支持的入金方式与对应银行账户信息
2. 法币充值阶段
用户需从其本人账户向 Legend 指定银行账户发起转账，并填写正确的 Reference Code。
3. 法币到账通知
当用户转账成功到账后，系统将通过 settlement-update Webhook 推送结算状态：
- Settlement category:
WIRE_RECEIVED - Status:
settled：资金已到账并确认in progress：处理中
4. 余额实时同步
用户法币余额发生任何变动时，系统将通过 balance-update Webhook 实时推送最新余额，确保双方系统数据一致。
5. 交易购买阶段
用户可使用到账的法币余额发起购买加密资产的交易，具体交易流程可通过对应 API 完成。
交易流程中，平台与交易所通过以下 Webhook 实现实时同步：
/trade-notify：交易发起时通知交易所
/trade-execute：交易执行后返回结果
6. 数字货币结算
交易结束后，我们会通过 settlement-update Webhook 推送结算状态：
- Settlement category:
CRYPTO_SENT - Status:
settled：已经完成结算in progress：处理中
注意：即使是交易所结算的模式，我们也会发送这个webhook。
三、合规说明
根据合规要求，Legend 不会长期存储用户法币余额。若用户法币资金到账后一个月内未转换为数字货币，系统将自动执行交易，将该笔法币转换为 USDT/USDC。