出金 - Offramp

功能概述

直接接入 Legend 法币出金 API，将法币出金功能集成到交易所内，支持更大额度的资金提取，同时为用户提供流畅、安全的出金体验。通过 Offramp 流程，用户可以将持有的加密货币兑换为法币并提现至个人银行账户。

用户流程概述

出金流程包含以下关键步骤：

1. 询价：用户查询当前可兑换的法币金额及费率
2. 添加银行账户：用户绑定用于接收法币的个人银行账户
3. 发起交易：用户确认卖出加密货币
4. 资金汇出：Legend 将法币汇入用户银行账户
5. 结果通知：通过 Webhook 实时通知交易及汇款状态

核心业务流程

2.1 询价

用户在发起出金交易前，需要先获取实时报价。

接口：/app/offrampquote

参考界面如下：

2.2 查询支持的出金方式

获取对当前用户支持的所有出金方式及法币币种。

接口：/app/withdrawmethods

2.3 添加银行账户

用户需要添加用于接收法币的个人银行账户。

参考界面如下：

2.3.1 获取银行账户字段要求

接口：/app/bankaccount/fields

2.3.2 添加银行账户

接口：/app/bankaccount

重要提示：

Legend does NOT accept third party wires, and only sends funds to the bank accounts under the applicant's name. Please ensure the bank account is registered under the same identity used for KYC verification.

2.4 发起交易

用户确认报价后，发起卖出交易。

接口：/app/offrampsell

参考界面如下：

交易成功：

2.5 查询交易详情

接口：/app/tradedetails

Webhook 通知机制

交易相关 Webhook

结算相关 Webhook

余额更新 Webhook

balance-update 文档：用户余额变动时触发，用于同步本地余额。

汇款处理说明

汇款状态流转

交易成功 → 提现发起 (pending) → 银行处理 (in progress) → 汇款成功 (settled)
                                      ↓
                                汇款失败 (rejected) → 余额回滚

汇款失败处理

若汇款失败（如银行账户信息错误），Legend 将：

1. 通过 settlement-update 发送 rejected 状态通知
2. 自动回滚用户法币余额（触发 balance-update）
3. 直接联系客户获取正确的银行账户信息
4. 重新发起汇款

最佳实践建议

1. Webhook 幂等性处理：确保您的回调接口能够处理重复通知
2. 状态同步：通过 settlement-update 和 balance-update 保持本地状态与 Legend 系统一致

相关接口列表