沙箱环境是支付宝开放平台为开发者提供的与生产环境完全隔离的联调测试环境，开发者在沙箱环境中完成的调用不会对生产环境中的数据造成任何影响。<br />沙箱环境会自动完成或忽略一些场景的业务门槛，例如：开发者无需等待产品签约，即可直接在沙箱环境调用接口，使得开发集成工作可以与商务流程并行，从而提高项目整体的交付效率。<br />**注意：**

- 由于沙箱环境并非 100% 与生产环境一致，接口的实际响应逻辑请以生产环境为准，沙箱环境开发调试完成后，仍然需要在生产环境进行测试验收。
- 沙箱环境拥有完全独立的数据体系，沙箱环境下返回的数据（比如用户 ID 等）在生产环境中都是不存在的，开发者不可将沙箱环境返回的数据与生产环境中的数据混淆。
- 本文仅说明如何在沙箱环境中调试手机网站支付能力，非调试通用说明。
- 沙箱环境不支持浏览器内付款，请打开 App 进行付款。
<a name="cZVzY"></a>
# 沙箱功能范围
<a name="aIA3Q"></a>
## 支持的接口
| **接口类型** | **接口中文名** | **接口英文名称** | **沙箱环境是否支持** | **沙箱环境调用注意事项** |
| --- | --- | --- | --- | --- |
| 手机网站支付 | 手机网站支付接口2.0 | [alipay.trade.wap.pay](https://opendocs.alipay.com/open/02ivbs?scene=21) | 支持 | - |
| 辅助接口 | 统一收单交易查询 | [alipay.trade.query](https://opendocs.alipay.com/open/02ivbt) | 支持 | - |
|  | 统一收单交易退款接口 | [alipay.trade.refund](https://opendocs.alipay.com/open/02ivbx) | 支持 | <br />1. 沙箱环境进行退款，退款金额需和支付金额保持一致。<br />2. 沙箱环境无论退款是否成功，每笔交易订单仅支持调用一次退款接口。<br /> |
|  | 统一收单交易退款查询接口 | [alipay.trade.fastpay.refund.query](https://opendocs.alipay.com/open/02ivbv) | 支持 | - |
|  | 统一收单交易关闭接口 | [alipay.trade.close](https://opendocs.alipay.com/open/02ivbu) | 支持 | - |
|  | 查询对账单下载地址 | [alipay.data.dataservice.bill.downloadurl.query](https://opendocs.alipay.com/open/02ivbw) | 支持 | 沙箱环境只做模拟调用，下载账单为模板，账单内没有实际数据。 |
| From 蚂蚁消息接口 | 收单退款冲退完成通知 | [alipay.trade.refund.depositback.completed](https://opendocs.alipay.com/open/02ivby) | 不支持 | 沙箱环境不支持银行卡支付，无法模拟测试。 |

<a name="p7Nkd"></a>
# 沙箱调试注意事项
建议只传必传参数测试，避免部分参数只对生产环境兼容。
<a name="FS6wx"></a>
## 参数注意事项
alipay.trade.wap.pay 沙箱参数区别如下

| 参数 | 描述说明 |
| --- | --- |
| timeout_express | 相对超时参数<br />- 沙箱测试：不可超过当前时间 15 小时。<br />- 生产环境：最大不可超过合约约定时间，默认 15 天。<br /> |
| time_expire | 绝对超时参数<br />沙箱环境：不可超过当前时间 15 小时。 |
| extend_params | 花呗分期：不支持设置，沙箱不支持花呗分期测试。<br />示例："extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"} |
| ext_user_info | 外部指定买家，不支持设置。<br />沙箱环境无法校验买家身份信息。 |

<a name="c3vo1"></a>
## 支付注意事项

1. 沙箱测试只支持余额支付，不支持银行卡、余额宝、花呗等其它支付方式。
2. 沙箱测试会扣手续费，但沙箱扣款手续费比例不代表生产环境的情况，生产环境手续费请以签约协议为准。
3. 若使用纯客户端 Demo 测试（不结合服务端请求），建议 Demo中配置的密钥为 pkcs8 格式。<br />**注意**：测试完后正式上线，建议结合服务端请求，避免私钥设置在客户端导致泄漏、资损。
4. 手机安装有正式的支付宝钱包和沙箱钱包，测试（若无相关提示选择使用哪个钱包）一般默认是唤起的正式支付宝钱包支付，此时由于生产环境的支付宝钱包支付沙箱数据导致报错。该情况下，需可以查看支付页面背景是否是生产环境支付宝钱包页面进行判断，建议修改为沙箱钱包支付。
5. 手机网站支付若要在移动端模拟唤起沙箱钱包支付，请在 Android 手机中测试（目前沙箱支付宝钱包只有 Android 版），在 iOS 中只能模拟 H5 页面登录支付场景。
<a name="fHlXy"></a>
# 沙箱控制台操作指南
使用沙箱环境进行调试前，开发者需根据 [操作指引](https://opendocs.alipay.com/common/097jyh?pathHash=8fd32ef6#%E6%93%8D%E4%BD%9C%E6%AD%A5%E9%AA%A4) 完成沙箱控制台及接口调用配置。<br />**注意**：请使用沙箱应用信息以及沙箱网关：`https://openapi-sandbox.dl.alipaydev.com/gateway.do`