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

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

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

注意：

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

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

本文仅说明如何在沙箱环境中调试蚂蚁门店管理，非沙箱环境调试通用说明。

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

蚂蚁门店管理沙箱调试说明

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

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

业务用例：蚂蚁门店管理

1. 创建蚂蚁店铺

调用 OpenAPI：ant.merchant.expand.shop.create

入参示例值：

{
    "business_address": {
        "address": "蚂蚁A空间",
        "cityCode": "330100",
        "districtCode": "330106",
        "provinceCode": "330000"
    },
    "ip_role_id": "2088621980811097",
    "shop_category": "B0001",
    "shop_name": "沙箱巡检店铺202206142394560987",
    "shop_type": "01",
    "store_id": "XJ202206142394560987"
}

出参示例值：

{
    "ant_merchant_expand_shop_create_response": {
        "code": "10000",
        "msg": "Success",
        "order_id": "2022061400502000000001871381"
    } 
}

2. 商户申请单查询

调用 OpenAPI：ant.merchant.expand.order.query

入参示例值：

{
    "order_id": "2022061400502000000001871381"
}

出参示例值：

{
    "ant_merchant_expand_order_query_response": {
        "code": "10000",
        "msg": "Success",
        "merchant_name": "tv**jp",
        "apply_time": "2022-06-14 16:13:48",
        "ext_info": "{\"SHOP_ID\":\"2022061400077000000009860711\"}",
        "ip_role_id": [
            "2088621980811097"
        ],
        "status": "99"
    }
}

3. 接收店铺审核通过消息通知

接收 MsgAPI 消息：ant.merchant.expand.shop.save.passed

店铺审核通过消息示例值：

{
    "store_id": "XJ202206142394560987",
    "shop_id": "2022061400077000000009860711",
    "shop_name": "沙箱店铺202206142394560987",
    "order_id": "2022061400502000000001871381"
}

4. 修改蚂蚁店铺

调用 OpenAPI：ant.merchant.expand.shop.modify

入参示例值：

{
    "shop_id": "2022061400077000000009860711",
    "contact_mobile": "13200132000"
}

出参示例值：

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

5. 接收店铺修改成功消息通知

接收 MsgAPI 消息：ant.merchant.expand.shop.save.passed

店铺修改成功消息示例值：

{
    "store_id": "XJ202206142394560987",
    "shop_id": "2022061400077000000009860711",
    "shop_name": "沙箱店铺202206142394560987",
    "order_id": "2022061400502000000001871382"
}

6. 查询店铺

调用 OpenAPI：ant.merchant.expand.shop.query

入参示例值：

{
    "shop_id": "2022061400077000000009860711"
}

出参示例值：

{
    "ant_merchant_expand_shop_query_response": {
        "code": "10000",
        "msg": "Success",
        "shop_name": "沙箱店铺202206142394560987",
        "shop_category": "1720",
        "shop_id": "2022061400077000000009860711",
        "business_address": {
            "address": "蚂蚁A空间",
            "district_code": "330106",
            "city_code": "330100",
            "province_code": "330000",
            "latitude": "30.261121",
            "longitude": "120.104735"
        },
        "contact_mobile": "13200132000",
        "ip_role_id": "2088621980811097",
        "store_id": "XJ202206142394560987",
        "shop_type": "01"
    }
}

7. 分页查询店铺

调用 OpenAPI：ant.merchant.expand.shop.page.query

入参示例值：

{
    "ip_role_id": "2088621980811097",
    "page_num": 1,
    "page_size": 10
}

出参示例值：

{
    "ant_merchant_expand_shop_page_query_response": {
        "code": "10000",
        "msg": "Success",
        "total_pages": 2,
        "shop_infos": [
            {
                "shop_name": "沙箱店铺202206091685597813",
                "shop_category": "1720",
                "shop_status": "01",
                "shop_id": "2022060900077000000009852548",
                "business_address": {
                    "address": "蚂蚁A空间",
                    "district_code": "330106",
                    "city_code": "330100",
                    "province_code": "330000",
                    "latitude": "30.261121",
                    "longitude": "120.104735"
                },
                "contact_mobile": "@#updateContactMobile#@",
                "store_id": "XJ202206091685597813",
                "shop_type": "01"
            },
            {
                "shop_name": "沙箱巡检店铺202206091917969408",
                "shop_category": "1720",
                "shop_status": "01",
                "shop_id": "2022060900077000000009852544",
                "business_address": {
                    "address": "蚂蚁A空间",
                    "district_code": "330106",
                    "city_code": "330100",
                    "province_code": "330000",
                    "latitude": "30.261121",
                    "longitude": "120.104735"
                },
                "store_id": "XJ202206091917969408",
                "shop_type": "01"
            }
        ]
    }
}

8. 关闭蚂蚁店铺

调用 OpenAPI：ant.merchant.expand.shop.close

入参示例值：

{
    "shop_id": "2022060900077000000009852544"
}

出参示例值：

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

沙箱调试

蚂蚁门店管理沙箱调试说明#

业务用例：蚂蚁门店管理#

1. 创建蚂蚁店铺#

2. 商户申请单查询#

3. 接收店铺审核通过消息通知#

4. 修改蚂蚁店铺#

5. 接收店铺修改成功消息通知#

6. 查询店铺#

7. 分页查询店铺#

8. 关闭蚂蚁店铺#

蚂蚁门店管理沙箱调试说明

业务用例：蚂蚁门店管理

1. 创建蚂蚁店铺

2. 商户申请单查询

3. 接收店铺审核通过消息通知

4. 修改蚂蚁店铺

5. 接收店铺修改成功消息通知

6. 查询店铺

7. 分页查询店铺

8. 关闭蚂蚁店铺