更新时间：2025-11-28 16:17:27收藏订阅更新我的文档设置返回文档简介沙箱环境是支付宝开放平台为开发者提供的安全低门槛的测试环境，开发者在沙箱环境中调用接口无需具备所需的商业资质，无需绑定和开通产品，同时不会对生产环境中的数据造成任何影响。合理使用沙箱环境，可以让研发流程与商业流程并行，降低联调资损风险，加速项目的交付。前提条件●已经入驻支付宝开放平台，详情请参见 开发者账号注册。●已经创建一个应用，例如小程序应用，详情请参见 小程序应用文档指引。操作步骤步骤一：获取应用配置和支付宝网关信息1从 支付宝开放平台 进入 。 2选择需要调试的应用，获取应用配置信息，包括：appid、应用私钥、支付宝公钥、支付宝网关信息。 说明：点击公钥模式里面的 查看，可以快速拷贝应用私钥和支付宝公钥。步骤二：获取产品接入指南1以接入 jsapi支付 为例，在沙箱控制台应用信息下的产品列表，找到 jsapi支付，点击 查看文档。 2参考 调试文档 中的示例进行代码开发。步骤三：开发代码发起调用1参考如下示例代码，调用接口 alipay.trade.create 创建交易单。后续操作应用开发配置配置证书模式1点击 启用，打开证书模式。 2获取调用需要的应用私钥、应用公钥证书、支付宝公钥证书、支付宝根证书。 3基于证书模式，发起对支付宝网关的调用。自定义秘钥/证书开发者如需自定义密钥/证书信息，可在 开发信息 中选择 自定义密钥。说明：若开发者没有证书或者密钥对，可查看 常见问题 > 如何获取加签密钥/证书。websocket 长链接接入在沙箱环境使用 websocket 长链接接入需要将消息接口的订阅方式修改为 websocket，sdk 配置方式可以参考 websocket 长连接接入。说明：●沙箱环境的 serverhost为 openchannel-sandbox.dl.alipaydev.com。●将连接支付宝网关代码修改为：alipaymsgclient.setconnector(serverhost, false)。应用网关配置应用网关用于接收支付宝沙箱环境的异步通知（对接 from 蚂蚁消息），如创建门店的被动通知。注意：仅 http 订阅模式的 from 蚂蚁消息才需要配置应用网关，websocket 订阅模式的 from 蚂蚁消息无需配置应用网关。授权回调地址配置第三方应用授权或获取用户信息中用于接收授权回调信息的地址。使用相关产品时需进行配置：○第三方应用授权：授权 url 中的 redirect_uri 必须与此值相同。○获取用户信息：授权 url 中的 redirect_uri 的域名必须与此值相同(例如：授权回调地址配置：https://auth.example.com/authcallback高亮部分需和授权 url 相同)。接口内容加密方式配置加密后，接口的请求内容和响应内容将会由明文内容变为密文内容，可以提升接口内容传输的安全性。若不设置，则接口内容不会被加密。更多信息请参见 aes 加密说明。服务器域名白名单配置小程序如需访问支付宝客户端域外服务，需配置服务器域名白名单（例如 my.request、my.uploadfile）。配置的方法和规格跟线上一致。h5 域名配置针对小程序内打开 h5 页面，提供 web-view 组件内嵌，需配置 h5 页面的域名地址。配置的方法和规格跟线上一致。openurl 配置针对小程序不能通过 web-view 组件内嵌，提供 openurl 接口在小程序外打开 h5 页面。跟线上配置不同，沙箱控制台的 openurl 配置将在 1 分钟左右自动过审。spi开发接入在沙箱产品列表的已发布产品中添加 spi 产品。 完成产品添加后点击去开发，进入到 spi 配置页。 在 api 列表中选择 spi 接口并点击接入。 配置 spi 测试地址并保存。实现所有必须实现的 spi 接口后，点击上线。 订阅消息在沙箱应用页面下拉到 消息服务，在 from 平台 和 to 平台 标签页即可订阅所需监听的消息接口。
