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

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

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

注意：

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

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

本文仅说明如何在沙箱环境中调试订单中心，非沙箱环境调试通用说明。

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

订单中心沙箱调试说明

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

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

用例使用注意：

示例参数中的以下值需要修改后执行：

buyer_id: 使用沙箱环境默认分配的买家账号，来作为 buyer_id。

out_biz_no: 外部订单号，使用时需要保证唯一性，不跟其它开发者冲突，不要改变位数。

tiny_app_id: 使用沙箱环境默认分配的小程序应用的 APPID，注意该小程序需要自己完成上架。

上架沙箱默认分配的小程序：

可查看沙箱环境中如何联调小程序在 IDE 登录沙箱卖家账号，完成小程序版本上传沙箱环境。

上传完成后，进入沙箱控制台，点击上架小程序即可。
说明：由于沙箱环境不稳定，上架过程中，如果报系统错误，请刷新页面后重试，重试后还不成功，请联系技术支持

验证自己同步成功消息在支付宝上可以查看：
注意：暂时不支持消息盒子。

使用沙箱默认分配的买家账号登录沙箱支付宝后，扫描如下二维码。

支付宝将自动拉起订单中心小程序，如果消息已经发送，将得到类似如下的效果：
说明：线上如果要查看发给支付宝的消息显示是否正确，请到消息盒子，订单小程序中不一定有数据。

业务用例

扫码点餐订单同步

上传商品图片

调用 OpenAPI： alipay.merchant.item.file.upload（商品文件上传接口）

调用示例代码：

出参示例值：

{
 "material_id":"2019010100502200000000000001",
 "material_key":"A*bJXMRYFoBcIAAAGGGGAAAABjAQWWWW"
}

同步订单下单成功状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
  "record_id": "2022092200502300920200000000100000",
  "order_status": "CREATE",
  "order_id": "2022092200502300920200000000100000"
}

同步订单已支付状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
  "record_id": "2022092200502300920200000000100000",
  "order_status": "PAID",
  "order_id": "2022092200502300920200000000100000"
}

同步订单待取餐状态

调调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300920200000000100000",
  "order_status": "MEALS_TO_BE_TAKEN",
  "order_id": "2022092200502300920200000000100000"
}

同步订单已完成状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
  "record_id": "2022092200502300920200000000100000",
  "order_status": "FINISHED",
  "order_id": "2022092200502300920200000000100000"
}

零售到家订单同步

上传商品图片

调用 OpenAPI： alipay.merchant.item.file.upload（商品文件上传接口）

调用示例代码：

出参示例值：

{
 "material_id":"2019010100502200000000000001",
 "material_key":"A*bJXMRYFoBcIAAAGGGGAAAABjAQWWWW"
}

同步订单下单成功状态

调用 OpenAPI： alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300920200000000100106",
  "order_status": "CREATE",
  "order_id": "2022092200502300920200000000100109"
}

同步订单待支付状态

调用 OpenAPI： alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300920200000000100106",
  "order_status": "WAIT_PAY",
  "order_id": "2022092200502300920200000000100109"
}

同步订单待接单状态

调用 OpenAPI： alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300920200000000100106",
  "order_status": "PENDING",
  "order_id": "2022092200502300920200000000100109"
}

同步订单已接单状态

调用 OpenAPI： alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300920200000000100106",
  "order_status": "ORDER_TAKEN",
  "order_id": "2022092200502300920200000000100109"
}

同步订单待配送状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
  "record_id": "2022092200502300920200000000100106",
  "order_status": "TO_BE_DELIVERED",
  "order_id": "2022092200502300920200000000100109"
}

同步订单配送中状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300920200000000100106",
  "order_status": "IN_DELIVERY",
  "order_id": "2022092200502300920200000000100109"
}

支付宝查询订单实时信息

回调 SPI：spi.alipay.merchant.order.realtimeinfo.query

注意：目前沙箱控制台暂不支持SPI接口的主动触发回调，可查看线上环境 SPI 测试方式进行调试。

同步订单已送达状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300920200000000100106",
  "order_status": "DELIVERED",
  "order_id": "2022092200502300920200000000100109"
}

预约到店订单同步

上传商品图片

调用 OpenAPI： alipay.merchant.item.file.upload（商品文件上传接口）

调用示例代码：

出参示例值：

{
 "material_id":"2019010100502200000000000001",
 "material_key":"A*bJXMRYFoBcIAAAGGGGAAAABjAQWWWW"
}

同步订单支付成功状态

调用 OpenAPI： alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300090400000000100100",
  "order_status": "PAID",
  "order_id": "2022092200502300090400000000100428"
}

同步订单预约成功状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300090400000000100100",
  "order_status": "BOOK_SUCCESSFULLY",
  "order_id": "2022092200502300090400000000100428"
}

同步订单待商家确认状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300090400000000100100",
  "order_status": "PENDING",
  "order_id": "2022092200502300090400000000100428"
}

同步订单预约临期状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300090400000000100100",
  "order_status": "ARRIVAL_TIME",
  "order_id": "2022092200502300090400000000100428"
}

同步订单已到店状态

调用 OpenAPI：alipay.merchant.order.sync（订单数据同步接口）

入参示例值：

出参示例值：

{
 "record_id": "2022092200502300090400000000100100",
  "order_status": "DELIVERED",
  "order_id": "2022092200502300090400000000100428"
}

沙箱调试

订单中心沙箱调试说明#

业务用例#

扫码点餐订单同步#

上传商品图片#

同步订单下单成功状态#

同步订单已支付状态#

同步订单待取餐状态#

同步订单已完成状态#

零售到家订单同步#

上传商品图片#

同步订单下单成功状态#

同步订单待支付状态#

同步订单待接单状态#

同步订单已接单状态#

同步订单待配送状态#

同步订单配送中状态#

支付宝查询订单实时信息#

同步订单已送达状态#

预约到店订单同步#

上传商品图片#

同步订单支付成功状态#

同步订单预约成功状态#

同步订单待商家确认状态#

同步订单预约临期状态#

同步订单已到店状态#

订单中心沙箱调试说明

业务用例

扫码点餐订单同步

上传商品图片

同步订单下单成功状态

同步订单已支付状态

同步订单待取餐状态

同步订单已完成状态

零售到家订单同步

上传商品图片

同步订单下单成功状态

同步订单待支付状态

同步订单待接单状态

同步订单已接单状态

同步订单待配送状态

同步订单配送中状态

支付宝查询订单实时信息

同步订单已送达状态

预约到店订单同步

上传商品图片

同步订单支付成功状态

同步订单预约成功状态

同步订单待商家确认状态

同步订单预约临期状态

同步订单已到店状态