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

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

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

注意：

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

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

本文仅说明如何在沙箱环境中调试商家分账，非沙箱环境调试通用说明。

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

沙箱调试说明

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

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

注意：

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

其他交易辅助接口可以根据需求进行调用调试。

分账关系维护

分账关系绑定

OpenAPI：alipay.trade.royalty.relation.bind（分账关系绑定）

入参示例

出参示例

{
 "result_code":"SUCCESS"
}

说明：如果 type 为 loginName 可以通过沙箱控制台-账号管理查看沙箱用户名称。

分账关系查询

OpenAPI：alipay.trade.royalty.relation.batchquery（分账关系查询）

入参示例

出参示例

{
 "result_code":"SUCCESS",
 "receiver_list":[
 {
 "type":"userId",
 "account":"2088xxxxx00",
 "memo":"分账给测试商户",
 "login_name":"test@alitest.xyz",
 "bind_login_name":"test@alitest.xyz"
 }
 ],
 "total_page_num":10,
 "total_record_num":480,
 "current_page_num":1,
 "current_page_size":20
}

分账比例查询

OpenAPI：alipay.trade.royalty.rate.query（分账比例查询）

入参示例

示例出参

{
 "user_id":"2088XXXX1234",
 "max_ratio":80
}

分账关系解绑

OpenAPI：alipay.trade.royalty.relation.unbind（分账关系解绑）

入参示例

示例出参

{
 "result_code":"SUCCESS"
}

同步分账

下单并支付

OpenAPI：alipay.trade.create（统一收单交易创建接口）

入参示例

示例出参

{
 "out_trade_no":"20150423001001",
 "trade_no":"2015042321001004720200028594"
}

通过小程序 IDE（切换到 沙箱环境(新)）扫码并支付。

请求分账

OpenAPI：alipay.trade.order.settle（统一收单交易结算接口）

入参示例

示例出参

{
 "trade_no":"2015070921001004130000127422",
 "settle_no":"20210718002530070036530006474222"
}

查询分账信息

OpenAPI：alipay.trade.order.settle.query（交易分账查询接口）

入参示例

示例出参

{
 "out_request_no":"20210727001",
 "operation_dt":"2021-07-30 12:00:00",
 "royalty_detail_list":[
 {
 "operation_type":"transfer",
 "execute_dt":"2021-07-30 12:00:00",
 "trans_out":"2088111111111111",
 "trans_out_type":"userId",
 "trans_in":"2088111111112222",
 "trans_in_type":"userId",
 "amount":10.00,
 "state":"FAIL",
 "detail_id":"2023030610032004370215900000",
 "error_code":"TXN_RESULT_ACCOUNT_BALANCE_NOT_ENOUGH",
 "error_desc":"分账余额不足"
 }
 ]
}

异步分账

下单并支付

OpenAPI：alipay.trade.create（统一收单交易创建接口）

入参示例

示例出参

{
 "out_trade_no":"20150423001001",
 "trade_no":"2015042321001004720200028594"
}

通过小程序 IDE（切换到 沙箱环境(新)）扫码并支付。

请求异步分账

OpenAPI：alipay.trade.order.settle（统一收单交易结算接口）

示例入参

示例出参

{
 "trade_no":"2015070921001004130000127422",
 "settle_no":"20210718002530070036530006474222"
}

接收异步分账消息

MsgAPI：alipay.trade.order.settle.notify（交易分账结果通知）

通知消息示例

说明：MsgAPI 可以通过沙箱控制台-沙箱应用-消息服务订阅消息。

沙箱调试说明

沙箱调试说明#

分账关系维护#

分账关系绑定#

分账关系查询#

分账比例查询#

分账关系解绑#

同步分账#

下单并支付#

请求分账#

查询分账信息#

异步分账#

下单并支付#

请求异步分账#

接收异步分账消息#

沙箱调试说明

分账关系维护

分账关系绑定

分账关系查询

分账比例查询

分账关系解绑

同步分账

下单并支付

请求分账

查询分账信息

异步分账

下单并支付

请求异步分账

接收异步分账消息