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

沙箱为开放的产品提供 有限功能范围 的支持（覆盖的功能范围可查看下面的业务用例），可以覆盖产品的绝大部分核心链路和对接逻辑，便于开发者快速学习/尝试/开发/调试，推荐开发者遵循业务用例来使用沙箱。

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

注意：

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

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

本文仅说明如何在沙箱环境中调试小程序开发管理，非沙箱环境调试通用说明。

更多沙箱介绍和沙箱控制台使用说明可查看沙箱环境。

小程序开发管理沙箱调试说明

沙箱通过业务用例定义支持的功能范围。业务用例描述了典型业务场景下，开发者可通过先后对接哪些接口来实现业务目标，每个业务用例会为开发者提供接口调用时序与参数示例值。

推荐开发者遵循业务用例来使用沙箱。

注意：

示例参数值中与沙箱当前账号、应用上下文相关的参数，需开发者自行参照接入指南调用配套接口获取。

目前沙箱钱包端上相关的功能还不支持。

该产品只在新沙箱环境提供支持。

不支持在沙箱控制台执行上架操作。

业务用例

提审上架小程序

小程序版本提审

调用 OpenAPI：alipay.open.mini.version.audit.apply

说明：沙箱环境为了方便 OpenAPI 调试，提审都会默认通过。

入参示例值：**
**

{
  "app_version": "0.0.1",
  "version_desc": "小程序版本描述小程序版本描述小程序版本描述小程序版本描述小程序版本描述小程序版本描述",
  "app_slogan": "这是一个支付示例",
  "memo": "小程序示例",
  "service_region_info": "[{\"area_code\":\"310000\",\"area_name\":\"余杭区\",\"city_code\":\"310000\",\"city_name\":\"杭州市\",\"province_code\":\"310000\",\"province_name\":\"浙江省\"}]",
  "app_category_ids": "11_12;12_13",
  "service_email": "example@mail.com",
  "test_password": "12121",
  "license_no": "licenseNo",
  "app_name": "沙箱测试小程序",
  "license_name": "营业执照名称",
  "service_phone": "1121321312312312",
  "bundle_id": "com.alipay.alipaywallet",
  "app_desc": "这是一个沙箱小程序测试描述",
  "license_valid_date": "9999-12-31"
}

出参示例值：

{
  "alipay_open_mini_version_audit_apply_response": {
    "code": "10000",
    "msg": "Success"
  }
}

接收审核通过通知

接收 MsgAPI 消息：alipay.open.mini.version.audit.passed

消息业务参数示例值：

{
  "bundle_id": "com.alipay.alipaywallet",
  "mini_app_version": "0.0.18",
  "mini_app_id": "2021000119616038"
}

小程序灰度上架

调用 OpenAPI：alipay.open.mini.version.gray.online

入参示例值：

{
  "app_version": "0.0.18",
  "gray_strategy": "p1"
}

出参示例值：

{
  "alipay_open_mini_version_gray_online_response": {
    "code": "10000",
    "msg": "Success"
  }
}

小程序结束灰度

调用 OpenAPI：alipay.open.mini.version.gray.cancel

入参示例值：

{
  "app_version": "0.0.18"
}

出参示例值：

{
  "alipay_open_mini_version_gray_cancel_response": {
    "code": "10000",
    "msg": "Success"
  }
}

小程序上架

调用 OpenAPI：alipay.open.mini.version.online

入参示例值：

{
  "app_version": "0.0.18"
}

出参示例值：

{
  "alipay_open_mini_version_online_response": {
    "code": "10000",
    "msg": "Success"
  }
}

沙箱调试

小程序开发管理沙箱调试说明#

业务用例#

提审上架小程序#

小程序版本提审#

接收审核通过通知#

小程序灰度上架#

小程序结束灰度#

小程序上架#

小程序开发管理沙箱调试说明

业务用例

提审上架小程序

小程序版本提审

接收审核通过通知

小程序灰度上架

小程序结束灰度

小程序上架