沙盒环境 - Gate Pay DOCS

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

沙盒数据均为测试数据，凭证与生产环境不能混用。

环境地址

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

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

步骤	操作
1. 注册登录	进入沙盒后台，完成邮箱验证码注册或登录。
2. 获取凭证	在商户后台获取 `ClientId`、Payment API Secret，配置回调 URL。详见商户接入。
3. 调接口	使用沙盒 Base URL 调用目标接口，先验证查询类接口，再创建测试订单或收款码。详见快速开始。
4. 模拟支付	在订单详情、收银台或静态收款码列表中触发模拟支付，验证状态流转。
5. 验证回调	确认 Webhook 验签、幂等和状态同步正常。

持续扩展中，接口能力分批开放，联调前请以本列表为准。

模块	接口能力	接口路径
客户管理	新增客户	`/v1/pay/channelmanage/save`
	查询客户	`/v1/pay/channelmanage/list`
	修改客户	`/v1/pay/channelmanage/update`
	删除客户	`/v1/pay/channelmanage/delete`
静态地址 / 静态收款码	查询支持的网络和币种	`/v1/pay/fixedaddress/chains`
	创建静态收款地址	`/v1/pay/fixedaddress/save`
	创建 EVM 网络静态收款地址	`/merchant/open/v1/pay/fixedaddress/evm/save`
	查询静态收款地址列表	`/v1/pay/fixedaddress/list`
	查看静态收款地址详情	`/v1/pay/fixedaddress/detail`
	删除静态收款地址	`/v1/pay/fixedaddress/delete`
	查询静态收款码账单列表	`/v1/pay/fixedaddress/order/query`
收银台	收银台下单	`/v1/pay/checkout/order`
收银台	收银台单详情查询	`/v2/pay/order/query`
地址支付	查询支持链列表	`/v1/pay/address/chains`
	查询支持币种列表	`/v1/pay/address/currencies`
	根据订单币种查询支持闪兑的币种	`/v1/pay/address/supportedconvertcurrencies`
	下单	`/v1/pay/address/create`
	查询支付单详情	`/v1/pay/address/query`
	查询链上交易详情	`/v1/pay/address/transactiondetail`
	地址支付相关回调验证	以当前沙盒回调配置为准

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

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