已更新更新时间：2024-10-17 11:15:42文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档沙箱环境是支付宝开放平台为开发者提供的与生产环境完全隔离的联调测试环境，开发者在沙箱环境中完成的调用不会对生产环境中的数据造成任何影响。沙箱环境会自动完成或忽略一些场景的业务门槛，例如：开发者无需等待产品签约，即可直接在沙箱环境调用接口，使得开发集成工作可以与商务流程并行，从而提高项目整体的交付效率。注意：●由于沙箱环境并非 100% 与生产环境一致，接口的实际响应逻辑请以生产环境为准，沙箱环境开发调试完成后，仍然需要在生产环境进行测试验收。●沙箱环境拥有完全独立的数据体系，沙箱环境下返回的数据（比如用户 id 等）在生产环境中都是不存在的，开发者不可将沙箱环境返回的数据与生产环境中的数据混淆。●本文仅说明如何在沙箱环境中调试 app 支付能力，非调试通用说明。1 沙箱功能范围1.1 支持的接口接口类型接口中文名接口英文名称沙箱环境是否支持沙箱环境调用注意事项app支付app支付接口2.0alipay.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不支持沙箱环境不支持银行卡支付，无法模拟测试。2 沙箱调试注意事项建议只传必传参数测试，避免部分参数只对生产环境兼容。2.1 参数注意事项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外部指定买家，不支持设置。沙箱环境无法校验买家身份信息。2.2 支付注意事项1沙箱测试只支持余额支付，不支持银行卡、余额宝、花呗等其它凯发k8官方网娱乐官方的支付方式。2沙箱测试会扣手续费，但沙箱扣款手续费比例不代表生产环境的情况，生产环境手续费请以签约协议为准。3若使用纯客户端 demo 测试（不结合服务端请求），建议 demo 中配置的密钥为 pkcs8 格式。 注意：测试完后正式上线，建议结合服务端请求，避免私钥设置在客户端导致泄漏、资损。4手机安装有正式的支付宝钱包和沙箱钱包，测试（若无相关提示选择使用哪个钱包）一般默认是唤起的正式支付宝钱包支付，此时由于生产环境的支付宝钱包支付沙箱数据会导致报错。该情况下，需查看支付页面背景是否是生产环境支付宝钱包页面进行判断，建议修改为沙箱钱包支付。5app 支付只支持 android 版接入，在使用 sdk 时，在支付接口前调用如下方法用于切换沙箱环境与生产环境； 如果不使用此方法，默认使用生产环境。方法调用位置如下图所示：注意：在生产环境，必须将此代码注释。3 沙箱控制台操作指南使用沙箱环境进行调试前，开发者需根据 操作指引 完成沙箱控制台及接口调用配置。注意：请使用沙箱应用信息以及沙箱网关：https://openapi-sandbox.dl.alipaydev.com/gateway.do
