> ## Documentation Index
> Fetch the complete documentation index at: https://cobo.com/payments/llms.txt
> Use this file to discover all available pages before exploring further.

# Off-Ramp 对接

本文介绍如何将您收到的加密货币兑换为法币并转入您的银行账户。

## 前提条件

参考[转出目的地](/payments/cn/guides/destinations)，录入您的银行账户，并通过 Cobo 运营团队对该银行账户的审核。

## 操作步骤

### 1. 创建 Off-Ramp 对接请求

您可以通过 Payments App 或 Payments API 创建 Off-Ramp 对接请求。

<Tabs>
  <Tab title="Payments App" icon="pager">
    <Note>
      在开发环境中，您可以通过 Payments App 体验 Off-Ramp 对接的完整操作流程，但不支持实际的法币兑换和转账操作。
    </Note>

    1. 登录 Cobo Portal [开发环境](https://portal.dev.cobo.com/login)或[生产环境](https://portal.cobo.com/login)。
    2. 在左侧导航栏中点击 **Apps**，然后点击 **Payments** 卡片，启动 App。
    3. 在 App 的左侧导航栏中点击**资金管理** > **资金转出**。
    4. 您可以选择提取**商户余额**或**开发者余额**。在本例中，我们选择提取商户余额。点击**商户余额**卡片上的**转出**按钮。
    5. 在弹窗中，选择**法币出金**。

           <img src="https://mintcdn.com/mcpnow/kaVpJuS8XHBh6QPZ/payments/cn/images/payments/fiat-payout.png?fit=max&auto=format&n=kaVpJuS8XHBh6QPZ&q=85&s=4783995c57dc20c9795443c56bb25b6a" className="screenshot_full_screen" alt=" Off-Ramp 对接入口" width="3688" height="1106" data-path="payments/cn/images/payments/fiat-payout.png" />
    6. 填写出金信息，包括代币、商户名称、转出金额、以及接收银行账户。如需添加新的银行账户，请参考[转出目的地](/payments/cn/guides/destinations)。

    <Note>
      在法币出金页面，您可以查看本次出金涉及的各项费用明细和预计到账金额：

      * **跨链费用**：由于 Cobo 目前仅支持在特定链上进行 Off-Ramp 对接，如果您要出金的加密货币在其他链上，系统需要先将其转移到支持的链上。该操作会产生跨链费用，该费用将从出金金额中扣除。例如，如果您要出金的 USDT 在 Polygon 链上，而系统不支持 Polygon 链的 USDT 出金，则需要先将 USDT 从 Polygon 转移到支持的链上（如 TRON），并支付相应的跨链费用。
      * **手续费**：基于出金金额按比例收取的手续费。该费用从您的 Fee Station 账户中扣除，不会影响实际出金金额。
      * **预计到账金额**：系统根据当前汇率和各项费用，预估的最终到账法币金额。由于银行可能收取额外手续费，且汇率可能波动，实际到账金额可能与预估金额有所差异。
    </Note>

    7. 按照页面提示确认并提交出金信息。
  </Tab>

  <Tab title="Payments API" icon="code">
    1. 在创建出金请求前，您可以调用 [List merchant balances](/payments/en/api-references/payment/list-merchant-balances) 或 [Get developer balance](/payments/en/api-references/payment/get-developer-balance) 分别查询商户和开发者余额，用于确定可出金的最大金额。
    2. 调用 [Create payout](/payments/en/api-references/payment/create-payout) 创建出金请求。

    **基础参数**

    * `request_id`：您提供的唯一请求 ID，用于跟踪出金请求
    * `source_account`：付款来源账户。当从商户账户出金时，传入 Merchant Code；当从开发者账户出金时，设置为 `developer`。
    * `payout_channel`：设置为 `OffRamp`， Off-Ramp 对接

    **详情参数（payout\_params & recipient\_info）**

    | 参数组                 | 相关参数                         |
    | :------------------ | :--------------------------- |
    | **payout\_params**  | `amount`、`token_id`          |
    | **recipient\_info** | `currency`、`bank_account_id` |

    **参数说明：**

    * `amount`：加密货币金额
    * `token_id`：加密货币 ID（如 `ETH_USDT`、`TRON_USDT`）
    * `currency`：法币币种（目前仅支持 `USD`）。
    * `bank_account_id`：目标银行账户 ID，可调用 [List all bank accounts](/payments/en/api-references/payment/list-all-bank-accounts) 获取。
  </Tab>
</Tabs>

### 2. 完成二次确认、风控审核及交易签名

在创建出金请求后，基于您的提交方式、风控设置等因素，需要完成以下操作：

* 二次确认：如您通过 Payments App 进行 Off-Ramp 对接，则需要在 Cobo Guard 上确认该出金请求。
* 风控审核：如果您设置了交易风控，则可能需要审批员在 Cobo Guard 上批准该出金请求。
* 交易签名：如果您使用的是 MPC 钱包，则需要移动端签名人或服务端签名人签名，方可最终完成出金操作。

### 3. 跟进出金状态

您可以订阅 `payment.payout.status.updated` 事件，获取 Off-Ramp 对接状态的实时更新。请参考 [Webhook reference](/payments/cn/guides/status-and-events) 了解每个事件的详细触发条件和返回的数据结构。

您也可以通过 Payments App 或 Payments API 主动查询出金请求状态。

<Tabs>
  <Tab title="Payments App" icon="pager">
    1. 登录 Cobo Portal [开发环境](https://portal.dev.cobo.com/login)或[生产环境](https://portal.cobo.com/login)。
    2. 在左侧导航栏中点击 **Apps**，然后点击 **Payments** 卡片，启动 App。
    3. 在 App 的左侧导航栏中点击**资金管理** > **资金转出**。
    4. 在**资金转出历史**标签页查看所有出金请求的状态和详情。
  </Tab>

  <Tab title="Payments API" icon="code">
    您可以调用以下 API 操作查询出金请求状态：

    * [Get payout information](/payments/en/api-references/payment/get-payout-information) - 查询单个出金请求的详细信息
    * [List all payouts](/payments/en/api-references/payment/list-all-payouts)  - 查询所有出金请求的详细信息
  </Tab>
</Tabs>