#支付宝 沙箱环境中如何联调小程序

沙箱环境可以让开发者在小程序上线到正式环境之前进行调试和测试，不用担心测试数据干扰正式环境，从而安全且轻松地验证支付等关键场景。

沙箱环境切换调试流程如下图所示：

创建沙箱小程序

登录小程序开放平台，点击开发中心 > 选择沙箱小程序或直接点击小程序沙箱接入登录后进入沙箱界面。

1.png

一、获取沙箱小程序APPID和开发者沙箱账号

1、进入界面后沙箱环境已自动创建一个小程序应用和应用APPID，可以使用此应用进行沙箱调试。

注：

（1）小程序有上线状态的版本时，可使用沙箱钱包扫码访问小程序，如果需要拉最新的包，请清空沙箱钱包的本地缓存。

（2）小程序版本，是IDE开发者工具上传到沙箱环境。

（3）多端推送可以推送小程序到其他APP端(例如:微博)，供支持多端的开发者使用。

2.png

2.2.png

2、界面往下滑动到：登录沙箱钱包处获取开发者沙箱账号和密码。

3.png

二、设置接口加签方式/httpRequest接口请求域名白名单

1、设置接口加签方式

（1）需要对接开放平台服务端接口时，需要设置如下信息：

开发者要保证接口中使用的私钥与此处的公钥匹配，否则无法调用接口。可参考密钥的生成方法。 沙箱支付宝公钥与线上不同，请更换代码中配置。 4.png

（2） 向支付宝发起请求的网关。沙箱与线上不同，请更换代码中配置，编写代码时，请将：

a、请求网关修改为：https://openapi.alipaydev.com/gateway.do。

b、appid 切换为沙箱的 appid。

c、签名方式使用 RSA2。

d、应用私钥（private_key）使用第 1 步生成的 RSA2 (SHA256) 的私钥(请根据开发语言进行选择原始或 pkcs8 格式)。

e、支付宝公钥（public_key）切换为第 1 步配置后应用公钥后，点击查看支付宝公钥看到的公钥。

2、添加服务器域名白名单

沙箱小程序前端，需要请求商家服务器进行数据交互时，请在沙箱界面：httpRequest接口请求域名白名单处添加请求域名白名单，可以添加3个域名白名单。

5.png

下载沙箱钱包

使用浏览器扫一扫，扫描沙箱界面提供的二维码或者下方二维码，下载沙箱钱包并安装。

注：目前沙箱钱包仅提供Android版本，目前仅提供扫一扫、付款码、门店详情页、小程序功能，其余功能暂不提供。

6.png

登录沙箱钱包

使用沙箱界面提供的开发者沙箱账号登录沙箱钱包（该账号已经自动添加为该沙箱小程序应用的开发者）。

7.png

下载小程序开发者工具

下载并安装 小程序开发者工具（简称 IDE）。

版本要求：小程序开发者工具 0.70 及以上版本。

（1）启动IDE开发者工具 > 模版选取 > 入门。

（2）选择API-Demo，点击下一步 > 新建demo项目，进入IDE编辑界面。

8.png

一、安装沙箱环境切换插件

在左侧功能面板，点击扩展市场图标，点击沙箱环境切换插件的安装按钮，安装完成后，点击启用。

9.png

二、切换到沙箱环境

启用插件后，在IDE左上角，点击正式环境下拉框，选择沙箱环境，切换到沙箱环境。

10.png

三、使用支付宝沙箱钱包扫码登录

1、在IDE开发者工具栏右侧，点击登录按钮，弹出登录二维码。

2、使用沙箱钱包扫一扫，扫描二维码登录。

四、推送预览调试

使用IDE编辑器编程小程序代码完成后，点击模拟器上方预览推送沙箱环境真机预览调试。

特别提示

一、安全提醒

上线小程序到生产环境，为了避免安全风险，请将敏感信息直接配置到后端应用中，不要从前端传到后端。

二、线上环境

1、环境切换插件切换到正式环境。

2、GATEWAY_URL支付宝网关配置为：https://openapi.alipay.com/gateway.do。

3、将APP_ID、APP_PRIVATE_KEY、ALIPAY_PUBLIC_KEY配置为线上环境对应的小程序应用值，并在所有的请求参数中传入正式环境的GATEWAY_URL。

注：为避免安全风险，在小程序正式上线时，请不要使用在本沙箱环境中使用过的密钥。