沙箱环境是支付宝开放平台为开发者提供的与生产环境完全隔离的联调测试环境，开发者在沙箱环境中完成的调用不会对生产环境中的数据造成任何影响。

沙箱环境会自动完成或忽略一些场景的业务门槛，例如：开发者无需等待产品签约，即可直接在沙箱环境调用接口，使得开发集成工作可以与商务流程并行，从而提高项目整体的交付效率。

注意：

由于沙箱环境并非 100% 与生产环境一致，接口的实际响应逻辑请以生产环境为准，沙箱环境开发调试完成后，仍然需要在生产环境进行测试验收。

沙箱环境拥有完全独立的数据体系，沙箱环境下返回的数据（比如用户 ID 等）在生产环境中都是不存在的，开发者不可将沙箱环境返回的数据与生产环境中的数据混淆。

本文仅说明如何在沙箱环境中调试 App 支付能力，非调试通用说明。

沙箱功能范围

支持的接口

接口类型	接口中文名	接口英文名称	沙箱环境是否支持	沙箱环境调用注意事项
app支付	app支付接口2.0	alipay.trade.app.pay	支持	-
辅助接口	统一收单线下交易查询	alipay.trade.query	支持	-
统一收单交易退款接口	alipay.trade.refund	支持	-
统一收单交易退款查询接口	alipay.trade.fastpay.refund.query	支持	-
统一收单交易关闭接口	alipay.trade.close	支持	-
查询对账单下载地址	alipay.data.dataservice.bill.downloadurl.query	支持	沙箱环境只做模拟调用，下载账单为模板，账单内没有实际数据。
From 蚂蚁消息接口	收单退款冲退完成通知	alipay.trade.refund.depositback.completed	不支持	沙箱环境不支持银行卡支付，无法模拟测试。

建议只传必传参数测试，避免部分参数只对生产环境兼容。

alipay.trade.app.pay 沙箱参数区别如下

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

沙箱测试只支持余额支付，不支持银行卡、余额宝、花呗等其它支付方式。

沙箱测试会扣手续费，但沙箱扣款手续费比例不代表生产环境的情况，生产环境手续费请以签约协议为准。

若使用纯客户端 Demo 测试（不结合服务端请求），建议 Demo 中配置的密钥为 pkcs8 格式。
注意：测试完后正式上线，建议结合服务端请求，避免私钥设置在客户端导致泄漏、资损。

手机安装有正式的支付宝钱包和沙箱钱包，测试（若无相关提示选择使用哪个钱包）一般默认是唤起的正式支付宝钱包支付，此时由于生产环境的支付宝钱包支付沙箱数据会导致报错。该情况下，需查看支付页面背景是否是生产环境支付宝钱包页面进行判断，建议修改为沙箱钱包支付。

App 支付只支持 Android 版接入，在使用 SDK 时，在支付接口前调用如下方法用于切换沙箱环境与生产环境；如果不使用此方法，默认使用生产环境。

EnvUtils.setEnv(EnvUtils.EnvEnum.SANDBOX);

方法调用位置如下图所示：

**注意：**在生产环境，必须将此代码注释。

使用沙箱环境进行调试前，开发者需根据操作指引完成沙箱控制台及接口调用配置。

注意：请使用沙箱应用信息以及沙箱网关：https://openapi-sandbox.dl.alipaydev.com/gateway.do