> ## 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://pay.gate.com/zh/sandbox/pay-merchant)，完成邮箱验证码注册或登录。                                     |
| 2. 获取凭证 | 在商户后台获取 `ClientId`、Payment API Secret，配置回调 URL。详见 [商户接入](/essentials/version/100/cn/common/accessguide)。 |
| 3. 调接口  | 使用沙盒 Base URL 调用目标接口，先验证查询类接口，再创建测试订单或收款码。详见 [快速开始](/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>
  </tbody>
</table>

## 模拟能力说明

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

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

## Webhook

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

## 切换生产环境

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