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

# 沙盒环境

沙盒是与生产环境隔离的测试环境，用于接口联调和流程验证，不产生真实资金流转。

<div style={{ backgroundColor: '#F3FDE8', border: '1px solid #D5EFC0', borderRadius: '8px', color: '#3B8C24', fontWeight: 600, padding: '14px' }}>
  沙盒数据均为测试数据，凭证与生产环境不能混用。
</div>

## 环境地址

| 环境 | 基础 URL | 说明 |
| - | - | - |
| 沙盒 | `https://openplatform-sandbox.gateapi.io` | 测试与联调 |
| Production | `https://openplatform.gateapi.io` | 生产环境，产生真实资金流转 |

除特别说明外，API Path、签名规则与响应结构与生产环境一致。

## 快速开始

| 步骤 | 操作 |
| - | - |
| 1. 注册登录 | [进入沙盒后台](https://www.gate.com/zh/pay-merchant?source=doc)，完成邮箱验证码注册或登录。 |
| 2. 获取凭证 | 在商户后台获取 `ClientId`、Payment API Secret，配置回调 URL。详见 [商户接入](/global/essentials/version/100/cn/common/accessguide)。 |
| 3. 调接口 | 使用沙盒 Base URL 调用目标接口，先验证查询类接口，再创建测试订单或收款码。详见 [快速开始](/global/essentials/version/100/cn/common/quickstart)。 |
| 4. 模拟支付 | 在订单详情、收银台或静态收款码列表中触发模拟支付，验证状态流转。 |
| 5. 验证回调 | 确认 Webhook 验签、幂等和状态同步正常。 |

## 当前已支持接口

<div style={{ backgroundColor: '#F3FDE8', border: '1px solid #D5EFC0', borderRadius: '8px', color: '#3B8C24', fontWeight: 600, padding: '14px' }}>
  持续扩展中，接口能力分批开放，联调前请以本列表为准。
</div>

<table>
  <thead>
    <tr>
      <th style={{ textAlign: 'left', paddingRight: '16px' }}>模块</th>
      <th style={{ textAlign: 'left', paddingLeft: '0', paddingRight: '16px' }}>接口能力</th>
      <th style={{ textAlign: 'left' }}>接口路径</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }} rowspan="4">客户管理</td>
      <td style={{ textAlign: 'left', paddingLeft: '0', paddingRight: '16px' }}>新增客户</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/channelmanage/save</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询客户</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/channelmanage/list</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>修改客户</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/channelmanage/update</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>删除客户</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/channelmanage/delete</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }} rowspan="7">静态地址 / 静态收款码</td>
      <td style={{ textAlign: 'left', paddingLeft: '0', paddingRight: '16px' }}>查询支持的网络和币种</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/fixedaddress/chains</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>创建静态收款地址</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/fixedaddress/save</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>创建 EVM 网络静态收款地址</td>
      <td style={{ textAlign: 'left' }}><code>/merchant/open/v1/pay/fixedaddress/evm/save</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询静态收款地址列表</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/fixedaddress/list</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查看静态收款地址详情</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/fixedaddress/detail</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>删除静态收款地址</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/fixedaddress/delete</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询静态收款码账单列表</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/fixedaddress/order/query</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }} rowspan="2">收银台</td>
      <td style={{ textAlign: 'left', paddingLeft: '0', paddingRight: '16px' }}>收银台下单</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/checkout/order</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>收银台单详情查询</td>
      <td style={{ textAlign: 'left' }}><code>/v2/pay/order/query</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }} rowspan="7">地址支付</td>
      <td style={{ textAlign: 'left', paddingLeft: '0', paddingRight: '16px' }}>查询支持链列表</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/address/chains</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询支持币种列表</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/address/currencies</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>根据订单币种查询支持闪兑的币种</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/address/supportedconvertcurrencies</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>下单</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/address/create</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询支付单详情</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/address/query</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询链上交易详情</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/address/transactiondetail</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>地址支付相关回调验证</td>
      <td style={{ textAlign: 'left' }}>以当前沙盒回调配置为准</td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }} rowspan="5">提现</td>
      <td style={{ textAlign: 'left', paddingLeft: '0', paddingRight: '16px' }}>提现下单</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/withdraw</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>提现订单查询</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/withdraw/query</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询币种支持的链</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/wallet/currency\_chains</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>提现手续费查询</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/wallet/withdraw\_status</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>提现记录查询</td>
      <td style={{ textAlign: 'left' }}><code>/v1/pay/wallet/withdrawals</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }} rowspan="14">OTC</td>
      <td style={{ textAlign: 'left', paddingLeft: '0', paddingRight: '16px' }}>OTC 报价</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/v1/quote</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>创建入金订单</td>
      <td style={{ textAlign: 'left' }}><code>/payment/open/otc/api/recharge</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>确认已付款</td>
      <td style={{ textAlign: 'left' }}><code>/payment/open/otc/api/recharge/confirm</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>取消入金订单</td>
      <td style={{ textAlign: 'left' }}><code>/payment/open/otc/api/recharge/cancel</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>入金订单列表</td>
      <td style={{ textAlign: 'left' }}><code>/payment/open/otc/api/recharge/list</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>入金订单详情</td>
      <td style={{ textAlign: 'left' }}><code>/payment/open/otc/api/recharge/detail</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>创建出金订单</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/order/create</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>出金订单列表</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/order/list</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>出金订单详情</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/order/detail</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询银行可用国家</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/bank/country/list</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询银行账户列表</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/bank/list</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>创建银行账户</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/bank/create</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>提交银行账户补充材料</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/bank/material/supplement</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>删除银行账户</td>
      <td style={{ textAlign: 'left' }}><code>/withdraw/open/otc/api/bank/delete</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }} rowspan="14">机构</td>
      <td style={{ textAlign: 'left', paddingLeft: '0', paddingRight: '16px' }}>发起划转</td>
      <td style={{ textAlign: 'left' }}><code>/transfer/open/institution/v1/pay/transfer</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>划转详情</td>
      <td style={{ textAlign: 'left' }}><code>/transfer/open/institution/v1/pay/transfer/detail</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>发起代扣</td>
      <td style={{ textAlign: 'left' }}><code>/transfer/open/institution/v1/pay/charge</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>代扣详情</td>
      <td style={{ textAlign: 'left' }}><code>/transfer/open/institution/v1/pay/charges/detail</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>创建子账户</td>
      <td style={{ textAlign: 'left' }}><code>/merchant/open/institution/v1/accounts/create</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>更新子账户</td>
      <td style={{ textAlign: 'left' }}><code>/merchant/open/institution/v1/accounts/update</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询子账户详情</td>
      <td style={{ textAlign: 'left' }}><code>/merchant/open/institution/v1/accounts/query</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>分页查询子账户</td>
      <td style={{ textAlign: 'left' }}><code>/merchant/open/institution/v1/accounts/list</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>获取认证 URL</td>
      <td style={{ textAlign: 'left' }}><code>/cashier/open/v1/certification/url</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询认证状态</td>
      <td style={{ textAlign: 'left' }}><code>/cashier/open/v1/certification/verify/query</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>创建费用规则</td>
      <td style={{ textAlign: 'left' }}><code>/rate/commission\_rule</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>更新费用规则</td>
      <td style={{ textAlign: 'left' }}><code>/rate/commission\_rule/upgrade</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询费用配置规则详情</td>
      <td style={{ textAlign: 'left' }}><code>/rate/commission\_rule</code></td>
    </tr>

    <tr>
      <td style={{ textAlign: 'left', paddingRight: '16px' }}>查询费用规则列表</td>
      <td style={{ textAlign: 'left' }}><code>/rate/commission\_rule/list</code></td>
    </tr>
  </tbody>
</table>

## 模拟能力说明

沙盒不提供真实清结算。支付和退款均通过模拟入口触发，仅用于验证状态流转和回调。

| 业务 | 模拟内容 | 操作入口 |
| - | - | - |
| 收单 | 支付 | 订单详情<br />收银台页面（仅针对收银台订单） |
| 静态收款码 | 支付 | 静态收款码列表 |
| 退款 | 退款 | 收单订单详情页 |

## Webhook

通知结构、签名方式与重试规则与生产环境一致。通过模拟支付/退款触发回调，验证验签和幂等处理。详见 [通知](/global/essentials/version/100/cn/common/notification)。

## 切换生产环境

* Base URL 切换为 `https://openplatform.gateapi.io`
* 替换生产 `ClientId` 与 API Secret
* 配置生产回调 URL
* 确认签名、验签、幂等、回调重试逻辑已通过测试。
* 完成真实小额订单验证


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.