Home
Guides

出金 - 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

银行账户的表单字段并非固定，而是随币种（以及可选的支付方式）变化。传入目标 currency（选中支付方式时再一并传入 payment_method），依据返回的 name / label / placeholder 渲染表单。例如 EUR 返回 iban / swift_bic，而 USD 返回 bank_swift / routing_number。

2.3.2 添加银行账户

接口：/app/bankaccount

请将 /app/bankaccount/fields 返回的字段 name 原样提交至 params。

重要提示：

Legend 不接受第三方汇款，仅接受申请人本人名下银行账户的汇款。请确保该银行账户的开户身份与 KYC 验证所用身份一致。

2.4 发起交易

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

接口：/app/offrampsell

参考界面如下：


交易成功：


2.5 查询交易详情

接口：/app/tradedetails

Webhook 通知机制

交易相关 Webhook

Webhook触发时机说明
trade-notify 文档交易发起时推送交易已成功提交的通知
trade-execute 文档交易执行后推送交易最终结果（成功/失败）

结算相关 Webhook

Webhook触发时机说明
settlement-update 文档汇款处理后推送汇款状态更新

余额更新 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 系统一致

相关接口列表

接口功能描述
/app/offrampquote出金询价
/app/withdrawmethods查询支持的出金方式
/app/bankaccount/fields获取银行账户字段要求
/app/bankaccount添加银行账户
/app/offrampsell发起卖出交易
/app/withdraw手动发起提现（适用于手动提现模式）
/app/tradedetails查询交易详情
/app/fiatbalances查询法币余额

Updated 5 days ago