post
https://sandboxapi.legendtrading.com/app/refund
发起退款申请
用户通过该接口发起退款申请。发起成功后，用户会收到一封标题为：“Important Notice - Wire Refund Notification”的邮件。
退款申请规则说明
-
退款金额限制
每次退款申请的金额不得超过用户账户中对应币种的可用余额。 -
退款账户判定规则
系统将根据以下逻辑自动确定退款账户：- 自动退款：若用户仅绑定了一个该币种的有效银行账户，退款将直接退回至该账户。
- 人工确认：若用户未绑定任何账户，或绑定了多个该币种的银行账户，系统将通过邮件联系用户确认收款账户后再进行退款处理。
-
最低退款金额
- 日元（JPY）：最低退款金额为 3,900 JPY；
- 其他法币：最低退款金额为 30（按对应币种计）。
-
reference 参数规则
若请求中reference参数不为空，则系统将默认返回该 reference 对应的已提交退款记录。
查询参数说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例值 |
|---|---|---|---|---|---|
uid | string | 是 | 用户唯一标识符 | 380ee89 | |
asset_pay_to | string | 是 | EUR | 退款币种 | EUR |
amount_pay_to | float | 是 | 100 | 退款金额 | 100 |
reference | string | 否 | 1234567890 | ||
refund_reason | string | 是 | (无) | 退款原因 | (需具体说明) |
说明：
uid参数为必填的用户唯一标识asset_pay_to和amount_pay_to共同确定退款币种和金额refund_reason为必填字段，需提供具体的退款原因说明reference为可选参考字段，可用于关联业务信息
如果申请开启了Settlement-update和Balance-update webhoook，我们会发送如下的Webhook。
Balance-update
{"uid":"uid123","group":"settlement","category":"WIRE_REFUND","reference_id":"settlement_id_123","reference":null,"asset":"USD","amount_change":"20.00000000","amount_before":20,"amount_after":"0.00000000","created_at":"2026-02-13T20:09:53.134455Z"}Settlement-update
发起refund时会发送：
{"amount":"20.00","asset":"USD","category":"WIRE_REFUND","reference":null,"settlement_id":"settlement_id_123","status":"pending","txid":"","uid":"uid123","updated_at":"2026-02-13T20:09:53.000000Z"}
Legend 结算以后会发送：
{"amount":"20.00","asset":"USD","category":"WIRE_REFUND","reference":null,"settlement_id":"settlement_id_123","status":"settled","txid":"","uid":"uid123","updated_at":"2026-02-13T20:09:53.000000Z"}