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

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

注意：

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

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

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

沙箱控制台操作指南

沙箱控制台操作指南及应用配置说明详情点击沙箱环境-操作指引。

沙箱功能范围

接口类型	接口中文名	接口英文名称	沙箱环境是否支持	沙箱环境调用注意事项
扫码支付	统一收单线下交易预创建	alipay.trade.precreate	支持	-
统一收单交易创建接口	alipay.trade.create	支持	-
付款码支付	统一收单交易支付接口	alipay.trade.pay	支持	交易金额（total_amont）单笔2000元以上，需用户输入支付密码。注：正式环境要求支付金额单笔1000元以上，会唤起支付收银台输入密码支付。
辅助接口	统一收单线下交易查询	alipay.trade.query	支持
统一收单交易退款接口	alipay.trade.refund	支持
统一收单交易退款查询接口	alipay.trade.fastpay.refund.query	支持
统一收单交易撤销接口	alipay.trade.cancel	支持
统一收单交易关闭接口	alipay.trade.close	支持
查询对账单下载地址	alipay.data.dataservice.bill.downloadurl.query	支持	沙箱环境只做模拟调用，下载账单为模板，账单内没有实际数据
From 蚂蚁消息接口	收单退款冲退完成通知	alipay.trade.refund.depositback.completed	不支持	沙箱环境不支持银行卡支付，无法模拟测试

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

参数	描述说明
timeout_express	相对超时参数沙箱测试timeout_express不可超过当前时间15小时。正式环境timeout_express最大不可超过合约约定时间，默认3h。
extend_params	花呗分期：沙箱不支持花呗分期测试示例："extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"}

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

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

当面付支付方式：

条码付的auth_code需从沙箱钱包中获取付款码。

扫码付需使用沙箱钱包的扫一扫功能进行扫码支付。

创建接口的jsapi页面链接需在沙箱支付宝钱包内打开才可支付。

当面付不支持优惠核销。

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

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