post
https://exchange.com/api/settlement-update
结算状态变更回调接口
合作平台可通过实现此 Webhook 接口，接收用户结算状态变更的实时通知。
功能描述
当用户的结算状态（如充值、提现等）发生变化时，Legend 系统将通过此回调地址向交易所推送最新的状态信息。
实现要求
- 交易所需按约定规范部署并暴露此接口
- 接口需具备验证签名、处理状态更新及返回标准响应的能力
典型应用场景
- 接收用户充值和提现的成功/失败状态
- 同步结算记录的审核、处理中、已完成等状态流转
提示：此接口为双方系统联调的重要组成部分，请确保其稳定性和安全性。
查询参数说明
| 参数名 | 类型 | 必传 | 说明 | 示例值 |
|---|---|---|---|---|
uid | string | 是 | 与此结算记录关联的用户ID | user_12345 |
settlement_id | uuid | 是 | 在Legendtrading系统中的唯一结算标识符 | 987ddf77-a9ad-4bd |
category | string | 是 | 结算类型分类，例如 "WIRE_SENT"。详见结算分类表 | WIRE_SENT |
asset | string | 是 | 结算资产名称（法币或加密货币） | USD |
amount | string | 是 | 结算资产金额（法币金额或加密货币数量） | 1000.00 |
status | string | 是 | 结算状态：'pending'（待处理）、 'settled'（已完成）、 'canceled'（已取消）、 'in progress'（处理中）、 'rejected'（已拒绝） | settled |
updated_at | string | 是 | 记录的最后更新时间（ISO 8601格式） | 2024-01-15T10:30:00Z |
reference | string | 否 | 合作方创建此结算记录时传递的参考ID（将原样返回） | partner_r |
txid | string | 否 | 当分类为 CRYPTO_SENT 或 CRYPTO_SENT_FROM_AUTOTRADE 时的链上交易ID。空值表示尚未有交易ID | 0x4a5b6c |
payment_source | string | 否 | 支付方式默认不开启， card 信用卡/借记卡,balance 余额 |
说明：
- 所有金额字段均使用字符串类型，确保数值精度
- 时间字段需使用 ISO 8601 标准格式（UTC 时区）
reference字段最大长度不超过 255 个字符txid字段仅在加密货币转出相关的分类中有效