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

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

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

注意：

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

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

本文仅说明如何在沙箱环境中调试私域营销，非沙箱环境调试通用说明。

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

私域营销沙箱调试说明

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

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

业务用例 1：查询营销活动

条件查询活动列表

调用 OpenAPI：alipay.marketing.activity.batchquery

说明：

该接口出参值为沙箱固定数据，数据总数为 21 条，支持分页查询。

如果入参传递了 merchant_id 或 activity_status，出参中的 belong_merchant_id 或 activity_status 将会被设置为入参值，其他内容不会变化。

入参示例值：

{
    "page_num": 1,
    "page_size": 4
}

出参示例值：

{
    "alipay_marketing_activity_batchquery_response": {
        "code": "10000",
        "msg": "Success",
        "activity_lite_infos": [
            {
                "activity_id": "2022062000826004586300110013",
                "activity_name": "沙箱模拟满减券活动001",
                "activity_status": "ACTIVE",
                "belong_merchant_id": "2088102175963583",
                "create_time": "2022-05-31 23:14:17",
                "publish_end_time": "2022-06-30 23:59:59",
                "publish_start_time": "2022-06-01 00:00:00",
                "voucher_display_lite_info": {
                    "brand_logo": "https:\/\/mdn.alipayobjects.com\/mif_pub\/afts\/file\/A*qNqET7a02AgAAAAAAAAAAAAAG5B2AQ",
                    "brand_name": "沙箱模拟满减券活动001"
                },
                "voucher_type": "FIX_VOUCHER",
                "voucher_use_rule_lite_info": {
                    "fix_voucher": {
                        "amount": "0.90",
                        "floor_amount": "10.00",
                        "goods_name": "可口可乐"
                    }
                }
            },
            {
                "activity_id": "2022062000826004586300110014",
                "activity_name": "沙箱模拟满减券活动002",
                "activity_status": "ACTIVE",
                "belong_merchant_id": "2088102175963583",
                "create_time": "2022-06-08 10:04:46",
                "publish_end_time": "2022-07-08 23:59:59",
                "publish_start_time": "2022-06-08 00:00:00",
                "voucher_display_lite_info": {
                    "brand_logo": "https:\/\/mdn.alipayobjects.com\/mif_pub\/afts\/file\/A*qNqET7a02AgAAAAAAAAAAAAAG5B2AQ",
                    "brand_name": "沙箱模拟满减券活动002"
                },
                "voucher_type": "FIX_VOUCHER",
                "voucher_use_rule_lite_info": {
                    "fix_voucher": {
                        "amount": "0.90",
                        "floor_amount": "10.00",
                        "goods_name": "可口可乐"
                    }
                }
            },
            {
                "activity_id": "2022060800826004103715465703",
                "activity_name": "沙箱模拟特价券活动003",
                "activity_status": "ACTIVE",
                "belong_merchant_id": "2088102175963583",
                "create_time": "2022-06-08 10:02:35",
                "publish_end_time": "2022-07-08 23:59:59",
                "publish_start_time": "2022-06-08 00:00:00",
                "voucher_display_lite_info": {
                    "brand_logo": "https:\/\/mdn.alipayobjects.com\/mif_pub\/afts\/file\/A*qNqET7a02AgAAAAAAAAAAAAAG5B2AQ",
                    "brand_name": "沙箱模拟特价券活动003"
                },
                "voucher_type": "SPECIAL_VOUCHER",
                "voucher_use_rule_lite_info": {
                    "special_voucher": {
                        "floor_amount": "10.00",
                        "goods_name": "可乐",
                        "origin_amount": "0.90",
                        "special_amount": "1.00"
                    }
                }
            },
            {
                "activity_id": "2022060800826004103715465702",
                "activity_name": "沙箱模拟单品折扣券活动004",
                "activity_status": "ACTIVE",
                "belong_merchant_id": "2088102175963583",
                "create_time": "2022-06-08 10:00:23",
                "publish_end_time": "2022-07-08 23:59:59",
                "publish_start_time": "2022-06-08 00:00:00",
                "voucher_display_lite_info": {
                    "brand_logo": "https:\/\/mdn.alipayobjects.com\/mif_pub\/afts\/file\/A*qNqET7a02AgAAAAAAAAAAAAAG5B2AQ",
                    "brand_name": "沙箱模拟单品折扣券活动004"
                },
                "voucher_type": "DISCOUNT_VOUCHER",
                "voucher_use_rule_lite_info": {
                    "discount_voucher": {
                        "ceiling_amount": "0.10",
                        "discount": "9",
                        "floor_amount": "10.00",
                        "goods_name": "可乐",
                        "origin_amount": "0.90"
                    }
                }
            }
        ],
        "page_num": 1,
        "page_size": 4,
        "total_size": 21
    },
    "sign": "Cfzn4iPQut3ed0Vhh1ZIk+qrhdE7Q76qYgdQkVutifV5I8w64eVpFW/hlvmJqBuff6mHr1JhWNK8Ve6mR9npACDblXNx5oDkqVMYD56rZ6KxnAafeLkvi8sz++b/4z8b+OgDHjmYC28VGeV96chZeEhLh3Y/kxMv5k21VHzxFPumnCLVBKGQgka97CC/vG5I9u/bvlSRKiwnoi13UmXjaM/qOrJ7HdbKHJ1INkUHRW93Q1mlTPOO5h1SCoSBPltsxGms/JRXrgCBCUbUXSD5ddRzKRIvy5LtYgxQnG7uCynQHpsQKdtcHQBVA0irE5dNzvspw6G9PzEzGDGmuJfZIw=="
}

咨询当前用户是否可参加指定活动

调用 OpenAPI：alipay.marketing.activity.consult

入参示例值：

{
    "user_id": "2088622957849163",
    "consult_activity_info_list": [
        {
            "activity_id": "2022061400826004099500102537"
        }
    ]
}

出参示例值：

{
    "alipay_marketing_activity_consult_response": {
        "code": "10000",
        "msg": "Success",
        "consult_result_info_list": [
            {
                "activity_id": "2022061400826004099500102537",
                "consult_result_code": "SUCCESS"
            }
        ],
        "user_id": "2088622957849163"
    }
}

查询活动详情

调用 OpenAPI：alipay.marketing.activity.query

入参示例值：

{
    "activity_id": "2022061400826004586300102332"
}

出参示例值：

{
    "alipay_marketing_activity_query_response": {
        "code": "10000",
        "msg": "Success",
        "activity_id": "2022061400826004099500102537",
        "activity_name": "单品特价券享0.1特价",
        "activity_status": "ACTIVE",
        "belong_merchant_id": "2088621957795094",
        "publish_end_time": "2022-07-12 21:43:10",
        "publish_start_time": "2022-06-12 21:43:10",
        "voucher_display_info": {
            "brand_logo": "https:\/\/gw.alipayobjects.com\/mdn\/rms_d52ffc\/afts\/img\/A*ju84SZwNBSkAAAAAAAAAAABkARQnAQ",
            "brand_name": "沙箱品牌名称测试",
            "voucher_description": "沙箱环境测试",
            "voucher_detail_images": [
                "https:\/\/mdgwdev.alipay.net\/afts\/img\/A*WzH-TYdnjHbWeW5DsW1WSQAAARwnAQ\/original?bz=promo_merchant"
            ],
            "voucher_image": "https:\/\/mdgwdev.alipay.net\/afts\/img\/A*8JH4RoxnGkYczl1FjFbNsAAAARwnAQ\/original?bz=promo_merchant"
        },
        "voucher_send_rule": {
            "natural_person_limit": false,
            "phone_number_limit": false,
            "real_name_limit": true,
            "voucher_quantity": 20,
            "voucher_quantity_limit_per_user": 100,
            "voucher_quantity_limit_per_user_period_type": "LIFE_CYCLE"
        },
        "voucher_type": "SPECIAL_VOUCHER",
        "voucher_use_rule": {
            "special_voucher": {
                "floor_amount": "1.00",
                "goods_name": "单品特价券",
                "origin_amount": "10.00",
                "special_amount": "0.10"
            }
        }
    }
}

业务用例 2：查询活动适用范围

查询活动可用商户

调用 OpenAPI：alipay.marketing.activity.merchant.batchquery

说明：

该接口出参值为沙箱固定数据，数据总数为21条，支持分页查询。

如果入参传递了 activity_id，出参中的 activity_id 将会被设置为入参值。

如果入参传递了 merchant_id ，那么数据将只会有一条。

入参示例值：

{
    "activity_id": "2022061500826004586300103315",
    "page_num": 1,
    "page_size": 20
}

出参示例值：

{
    "alipay_marketing_activity_merchant_batchquery_response": {
        "code": "10000",
        "msg": "Success",
        "activity_id": "2022061500826004099500103319",
        "merchant_infos": [
            {
                "merchant_id": "2088102168512190",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512228",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512293",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512310",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512372",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512392",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512534",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512558",
                "merchant_id_type": "SMID"
            },
            {
                "merchant_id": "2088102168512633",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168513513",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168513510",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512211",
                "merchant_id_type": "SMID"
            },
            {
                "merchant_id": "2088102168512212",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512313",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512314",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512315",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "20881021685125316",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512517",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168512619",
                "merchant_id_type": "PID"
            },
            {
                "merchant_id": "2088102168513520",
                "merchant_id_type": "PID"
            }
        ],
        "page_num": 1,
        "page_size": 20,
        "total_size": 21
    }
}

查询活动可用小程序

调用 OpenAPI：alipay.marketing.activity.app.batchquery

说明：

该接口出参值为沙箱固定数据，数据总数为21条，支持分页查询。

如果入参传递了 activity_id，出参中的 activity_id 将会被设置为入参值，其他内容不会变化。

入参示例值：

{
    "activity_id": "2022061900826004586300107900",
    "page_num": 1,
    "page_size": 20
}

出参示例值：

{
    "alipay_marketing_activity_app_batchquery_response": {
        "code": "10000",
        "msg": "Success",
        "activity_id": "2022061500826004099500103319",
        "app_infos": [
            {
                "mini_app_id": "2016073000126887"
            },
            {
                "mini_app_id": "2016073000126944"
            },
            {
                "mini_app_id": "2016073000127026"
            },
            {
                "mini_app_id": "2016073000127184"
            },
            {
                "mini_app_id": "2016073000127210"
            },
            {
                "mini_app_id": "2016073000127290"
            },
            {
                "mini_app_id": "2016073000127403"
            },
            {
                "mini_app_id": "2016073000127404"
            },
            {
                "mini_app_id": "2016073000127406"
            },
            {
                "mini_app_id": "2016073000127413"
            },
            {
                "mini_app_id": "2016073000127414"
            },
            {
                "mini_app_id": "2016073000127415"
            },
            {
                "mini_app_id": "2016073000127416"
            },
            {
                "mini_app_id": "2016073000127417"
            },
            {
                "mini_app_id": "2016073000127418"
            },
            {
                "mini_app_id": "2016073000127219"
            },
            {
                "mini_app_id": "2016073000127220"
            },
            {
                "mini_app_id": "2016073000127221"
            },
            {
                "mini_app_id": "2016073000127222"
            },
            {
                "mini_app_id": "2016073000127223"
            }
        ],
        "page_num": 1,
        "page_size": 20,
        "total_size": 21
    }
}

查询活动可用门店

调用 OpenAPI：alipay.marketing.activity.shop.batchquery

说明：

该接口出参值为沙箱固定数据，数据总数为21条，支持分页查询。

如果入参传递了 activity_id，出参的 activity_id 将会被设置为入参值，其他内容不会变化。

入参示例值：

{
    "merchant_id": "2088621957795094",
    "activity_id": "2022061500826004586300103315",
    "page_num": 1,
    "page_size": 20
}

出参示例值：

{
    "alipay_marketing_activity_shop_batchquery_response": {
        "code": "10000",
        "msg": "Success",
        "activity_id": "2022061500826004099500103319",
        "page_num": 1,
        "page_size": 20,
        "shop_infos": [
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860711",
                "shop_name": "沙箱模拟店铺2022061400077000000009860711",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860712",
                "shop_name": "沙箱模拟店铺2022061400077000000009860712",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860713",
                "shop_name": "沙箱模拟店铺2022061400077000000009860713",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860714",
                "shop_name": "沙箱模拟店铺2022061400077000000009860714",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860715",
                "shop_name": "沙箱模拟店铺2022061400077000000009860715",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860716",
                "shop_name": "沙箱模拟店铺2022061400077000000009860716",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860717",
                "shop_name": "沙箱模拟店铺2022061400077000000009860717",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860718",
                "shop_name": "沙箱模拟店铺2022061400077000000009860718",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860719",
                "shop_name": "沙箱模拟店铺2022061400077000000009860719",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860720",
                "shop_name": "沙箱模拟店铺2022061400077000000009860720",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860721",
                "shop_name": "沙箱模拟店铺2022061400077000000009860721",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860722",
                "shop_name": "沙箱模拟店铺2022061400077000000009860722",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860723",
                "shop_name": "沙箱模拟店铺2022061400077000000009860723",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860724",
                "shop_name": "沙箱模拟店铺2022061400077000000009860724",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860725",
                "shop_name": "沙箱模拟店铺2022061400077000000009860725",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860726",
                "shop_name": "沙箱模拟店铺2022061400077000000009860726",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860727",
                "shop_name": "沙箱模拟店铺2022061400077000000009860727",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860728",
                "shop_name": "沙箱模拟店铺2022061400077000000009860728",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860729",
                "shop_name": "沙箱模拟店铺2022061400077000000009860729",
                "shop_type": "01"
            },
            {
                "latitude": "30.261121",
                "longitude": "120.104735",
                "shop_id": "2022061400077000000009860730",
                "shop_name": "沙箱模拟店铺2022061400077000000009860730",
                "shop_type": "01"
            }
        ],
        "total_size": 21
    }
}

查询活动适用商品

调用 OpenAPI：alipay.marketing.activity.goods.batchquery

说明：

该接口出参值为沙箱固定数据，数据总数为21条，支持分页查询。

如果入参传递了 activity_id，出参中的 activity_id 将会被设置为入参值，其他内容不会变化。

入参示例值：

{
    "merchant_id": "2088621957795094",
    "activity_id": "2022061500826004586300103315",
    "page_num": 1,
    "page_size": 20
}

出参示例值：

{
    "alipay_marketing_activity_goods_batchquery_response": {
        "code": "10000",
        "msg": "Success",
        "activity_id": "2022061500826004099500103319",
        "goods_infos": [
            {
                "goods_id": "sandboxMockGoods@001",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@002",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@003",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@004",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@005",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@006",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@007",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@008",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@009",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@010",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@011",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@012",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@013",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@014",
                "goods_use_type": "UNAVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@015",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@016",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@017",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@018",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@019",
                "goods_use_type": "AVAILABLE"
            },
            {
                "goods_id": "sandboxMockGoods@020",
                "goods_use_type": "AVAILABLE"
            }
        ],
        "page_num": 1,
        "page_size": 20,
        "total_size": 21
    }
}

业务用例 3：小程序内领券核销

沙箱模拟用户领券

沙箱模拟用户领券链接拼接规则：

http://render.sx.alipaydev.com/get-coupon.html?activityId=${activityId}&appId=${appId}

说明：

将链接中的 ${activityId} 和 ${appId} 替换为沙箱环境下创建的商家券活动 ID 以及沙箱环境中自己的沙箱应用 APPID 后，将此链接转换为二维码图片。使用支付宝沙箱客户端 APP，登录沙箱分配的买家账号（注意不是商家账号）后，扫上一步生成的二维码，根据指引完成领券。

该拼接链接的方式只适用于 沙箱环境，生产环境需要按照开发接入推广、领取商家券。

接收领券消息

接收 MsgAPI 消息：alipay.marketing.activity.message.received

领券消息内容示例值：

{
    "activity_id": "2022061500826004099500103372",
    "voucher_id": "202206150007300216490002HEIH",
    "receive_user_id": "2088622957849163",
    "voucher_code": "5055b4ec-98b7-46d4-9793-a5bb5d5e6afc",
    "id": "RECEIVED_2022061500073011164900027YYK",
    "event_time": "1655279307591"
}

同步券核销状态

调用 OpenAPI：alipay.marketing.activity.ordervoucher.use

入参示例值：

{
    "biz_dt": "2022-06-15 14:20:15",
    "total_fee": 0.01,
    "activity_id": "2022061500826004586300103449",
    "trade_channel": "ZHIFUBAO_TRADE_CHANNEL",
    "trade_no": "2220150320010101031",
    "voucher_code": "5055b4ec-98b7-46d4-9793-a5bb5d5e6afc",
    "out_biz_no": "202206158065912821",
    "goods_detail": [
        {
            "goods_name": "ipad",
            "quantity": 1,
            "price": 2000,
            "goods_id": "apple-01"
        }
    ]
}

出参示例值：

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

业务用例 4：小程序内领券过期

沙箱模拟用户领券

沙箱模拟用户领券链接拼接规则：

http://render.sx.alipaydev.com/get-coupon.html?activityId=${activityId}&appId=${appId}

说明：

将链接中的 ${activityId} 和 ${appId} 替换为沙箱环境下创建的商家券活动 ID 以及沙箱环境中自己的沙箱应用 APPID 后，将此链接转换为二维码图片。使用支付宝沙箱客户端APP，登录沙箱分配的买家账号（注意不是商家账号）后，扫上一步生成的二维码，根据指引完成领券。

该拼接链接的方式只适用于 沙箱环境，生产环境需要按照开发接入推广、领取商家券。

接收领券消息

接收 MsgAPI 消息：alipay.marketing.activity.message.received

领券消息内容示例值：

{
    "activity_id": "2022061500826004099500103372",
    "voucher_id": "202206150007300216490002HEIH",
    "receive_user_id": "2088622957849163",
    "voucher_code": "5055b4ec-98b7-46d4-9793-a5bb5d5e6afc",
    "id": "RECEIVED_2022061500073011164900027YYK",
    "event_time": "1655279307591"
}

使券失效

调用 OpenAPI：alipay.marketing.activity.ordervoucher.invalid

入参示例值：

{
    "biz_dt": "2022-06-19 15:42:21",
    "activity_id": "2022061500826004099500103372",
    "voucher_code": "5055b4ec-98b7-46d4-9793-a5bb5d5e6afc",
    "out_biz_no": "202206198716601415"
}

出参示例值：

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

沙箱调试

私域营销沙箱调试说明#

业务用例 1：查询营销活动#

条件查询活动列表#

咨询当前用户是否可参加指定活动#

查询活动详情#

业务用例 2：查询活动适用范围#

查询活动可用商户#

查询活动可用小程序#

查询活动可用门店#

查询活动适用商品#

业务用例 3：小程序内领券核销#

沙箱模拟用户领券#

接收领券消息#

同步券核销状态#

业务用例 4：小程序内领券过期#

沙箱模拟用户领券#

接收领券消息#

使券失效#

私域营销沙箱调试说明

业务用例 1：查询营销活动

条件查询活动列表

咨询当前用户是否可参加指定活动

查询活动详情

业务用例 2：查询活动适用范围

查询活动可用商户

查询活动可用小程序

查询活动可用门店

查询活动适用商品

业务用例 3：小程序内领券核销

沙箱模拟用户领券

接收领券消息

同步券核销状态

业务用例 4：小程序内领券过期

沙箱模拟用户领券

接收领券消息

使券失效