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

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

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

注意：

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

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

本文仅说明如何在沙箱环境中调试 引流转化，非沙箱环境调试通用说明。

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

沙箱调试说明

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

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

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

业务用例

管理附近推广计划

上传营销图片资源

调用 OpenAPI：alipay.marketing.material.image.upload（营销图片资源上传接口）

调用示例代码：

AlipayMarketingMaterialImageUploadRequest request = new AlipayMarketingMaterialImageUploadRequest();
FileItem fileItem = new FileItem("/Users/test/test600.jpg");
request.setFileContent(fileItem);
request.setFileKey("DELIVERY_CHANNEL_PIC");
AlipayMarketingMaterialImageUploadResponse response = alipayClient.execute(request);
if (response.isSuccess()) {
    System.out.println("成功");
    System.out.println(response.getBody());
} else {
    System.out.println("失败");
}

出参示例值：

{
    "alipay_marketing_material_image_upload_response": {
        "code": "10000",
        "msg": "Success",
        "resource_id": "A*WzH-TYdnjHbtU7pBltzmAAAAARwnAQ"
    }
}

创建推广计划

调用 OpenAPI：alipay.marketing.activity.delivery.create（创建推广计划）

入参示例值：

{
    "delivery_base_info": {
        "delivery_material": {
            "delivery_single_material": {
                "delivery_image": "A*WzH-TYdnjHbdwbxKrRmWUAAAARwnAQ"
            }
        },
        "delivery_end_time": "2022-10-28 16:35:09",
        "delivery_name": "团购券附近推广测试",
        "delivery_begin_time": "2022-08-29 16:35:09"
    },
    "delivery_play_config": {
        "delivery_single_send_config": {
            "delivery_content_config": {
                "delivery_send_guide": {
                    "delivery_guide_url": "alipays://platformapi/startapp?appId=2016091700528530&noneExit=true&from=voucher&test=fuge"
                }
            },
            "delivery_content_info": {
                "delivery_content_type": "ACTIVITY",
                "delivery_activity_content": {
                    "activity_id": "2022092800826004586300207818"
                }
            }
        }
    },
    "delivery_booth_code": "PUBLIC_UNION",
    "delivery_target_rule": {
        "delivery_recall_mode": "SHOP_RECALL"
    },
    "merchant_access_mode": "SELF_MODE",
    "out_biz_no": "202209288346753210"
}

出参示例值：

{
    "alipay_marketing_activity_delivery_create_response": {
        "msg": "Success",
        "code": "10000",
        "delivery_id": "2022092800826029586300081229"
    }
}

接收推广计划变更成功消息

接收 MsgAPI 消息：alipay.marketing.activity.delivery.changed（推广计划状态变更消息）

投放计划变更成功消息示例值：

{
    "delivery_id": "2022092800826029586300081229",
    "out_biz_no": "202209288346753210",
    "delivery_booth_code": "PUBLIC_UNION",
    "delivery_status": "ACTIVE",
    "event_time": "1664354112489"
}

查询推广计划

调用 OpenAPI：alipay.marketing.activity.delivery.query（查询推广计划）

入参示例值：

{
    "merchant_access_mode": "SELF_MODE",
    "delivery_id": "2022092800826029586300081229"
}

出参示例值：

{
    "alipay_marketing_activity_delivery_query_response": {
        "msg": "Success",
        "delivery_base_info": {
            "delivery_end_time": "2022-10-28 16:35:09",
            "delivery_name": "团购券附近推广测试",
            "delivery_begin_time": "2022-08-29 16:35:09"
        },
        "code": "10000",
        "delivery_id": "2022092800826029586300081229",
        "delivery_play_config": {
            "delivery_single_send_config": {
                "delivery_content_config": {
                    "delivery_send_guide": {
                        "delivery_guide_url": "alipays://platformapi/startapp?appId=2016091700528530&noneExit=true&from=voucher&test=fuge"
                    }
                },
                "delivery_content_info": {
                    "delivery_content_type": "ACTIVITY",
                    "delivery_activity_content": {
                        "activity_id": "2022092800826004586300207818"
                    }
                }
            }
        },
        "delivery_booth_code": "PUBLIC_UNION",
        "delivery_target_rule": {
            "delivery_recall_mode": "SHOP_RECALL",
            "delivery_merchant_rule": {
                
            }
        },
        "delivery_status": "ACTIVE"
    }
}

停止推广

调用 OpenAPI：alipay.marketing.activity.delivery.stop（停止推广计划）

入参示例值：

{
 "merchant_access_mode": "SELF_MODE",
 "delivery_id": "2022092800826029586300081229",
 "out_biz_no": "202209288346753210"
}

出参示例值：

{
    "alipay_marketing_activity_delivery_stop_response": {
        "msg": "Success",
        "code": "10000",
        "delivery_id": "2022092800826029586300081229"
 }
}

管理全城推广计划

上传营销图片资源

调用 OpenAPI：alipay.marketing.material.image.upload（营销图片资源上传接口）

调用示例代码：

AlipayMarketingMaterialImageUploadRequest request = new AlipayMarketingMaterialImageUploadRequest();
FileItem fileItem = new FileItem("/Users/test/test600.jpg");
request.setFileContent(fileItem);
request.setFileKey("DELIVERY_CHANNEL_PIC");
AlipayMarketingMaterialImageUploadResponse response = alipayClient.execute(request);
if (response.isSuccess()) {
    System.out.println("成功");
    System.out.println(response.getBody());
} else {
    System.out.println("失败");
}

出参示例值：

{
    "alipay_marketing_material_image_upload_response": {
        "code": "10000",
        "msg": "Success",
        "resource_id": "A*WzH-TYdnjHbtU7pBltzmAAAAARwnAQ"
    }
}

创建推广计划

调用OpenAPI：alipay.marketing.activity.delivery.create（创建推广计划）

入参示例值：

{
    "delivery_base_info": {
        "delivery_material": {
            "delivery_single_material": {
                "delivery_image": "A*WzH-TYdnjHbdwbxKrRmWUAAAARwnAQ"
            }
        },
        "delivery_end_time": "2022-10-28 16:30:13",
        "delivery_name": "团购券全城推广测试",
        "delivery_begin_time": "2022-08-29 16:30:13"
    },
    "delivery_play_config": {
        "delivery_single_send_config": {
            "delivery_content_config": {
                "delivery_send_guide": {
                    "delivery_guide_url": "alipays://platformapi/startapp?appId=2016091700528530&noneExit=true&from=voucher&test=fuge"
                }
            },
            "delivery_content_info": {
                "delivery_content_type": "ACTIVITY",
                "delivery_activity_content": {
                    "activity_id": "2022092800826004586300207934"
                }
            }
        }
    },
    "delivery_booth_code": "PUBLIC_UNION",
    "delivery_target_rule": {
        "delivery_recall_mode": "CITY_RECALL",
        "delivery_city_code_rule": {
            "city_codes": [
                "431200"
            ],
            "all_city": ""
        }
    },
    "merchant_access_mode": "SELF_MODE",
    "out_biz_no": "202209280949443267"
}

出参示例值：

{
  "alipay_marketing_activity_delivery_create_response": {
    "msg": "Success",
    "code": "10000",
    "delivery_id": "2022092800826029586300081404"
  }
}

接收推广计划变更成功消息

接收 MsgAPI 消息：alipay.marketing.activity.delivery.changed（推广计划状态变更消息）

消息业务参数示例值：

{
  "delivery_id": "2022092800826029586300081404",
  "out_biz_no": "202209280949443267",
  "delivery_booth_code": "PUBLIC_UNION",
  "delivery_status": "ACTIVE",
  "event_time": "1664353817465"
}

查询推广计划

调用 OpenAPI：alipay.marketing.activity.delivery.query（查询推广计划）

入参示例值：

{
  "merchant_access_mode": "SELF_MODE",
  "delivery_id": "2022092800826029586300081404"
}

出参示例值：

{
    "alipay_marketing_activity_delivery_query_response": {
        "msg": "Success",
        "delivery_base_info": {
            "delivery_end_time": "2022-10-28 16:30:13",
            "delivery_name": "团购券全城推广测试",
            "delivery_begin_time": "2022-08-29 16:30:13"
        },
        "code": "10000",
        "delivery_id": "2022092800826029586300081404",
        "delivery_play_config": {
            "delivery_single_send_config": {
                "delivery_content_config": {
                    "delivery_send_guide": {
                        "delivery_guide_url": "alipays://platformapi/startapp?appId=2016091700528530&noneExit=true&from=voucher&test=fuge"
                    }
                },
                "delivery_content_info": {
                    "delivery_content_type": "ACTIVITY",
                    "delivery_activity_content": {
                        "activity_id": "2022092800826004586300207934"
                    }
                }
            }
        },
        "delivery_booth_code": "PUBLIC_UNION",
        "delivery_target_rule": {
            "delivery_recall_mode": "CITY_RECALL",
            "delivery_city_code_rule": {
                "city_codes": [
                    "431200"
                ]
            },
            "delivery_available_scope": {
                "delivery_available_city_code": {
                    "city_codes": [
                        "431200"
                    ]
                },
                "delivery_available_scope_type": "CITY_CODE"
            },
            "delivery_merchant_rule": {
                
            }
        },
        "delivery_status": "ACTIVE"
    }
}

停止推广

调用 OpenAPI：alipay.marketing.activity.delivery.stop（停止推广计划）

入参示例值：

{
  "merchant_access_mode": "SELF_MODE",
  "delivery_id": "2022092800826029586300081404",
  "out_biz_no": "202209280949443267"
}

出参示例值：

{
  "alipay_marketing_activity_delivery_stop_response": {
    "msg": "Success",
    "code": "10000",
    "delivery_id": "2022092800826029586300081404"
  }
}

沙箱调试

沙箱调试说明#

业务用例#

管理附近推广计划#

上传营销图片资源#

创建推广计划#

接收推广计划变更成功消息#

查询推广计划#

停止推广#

管理全城推广计划#

上传营销图片资源#

创建推广计划#

接收推广计划变更成功消息#

查询推广计划#

停止推广#

沙箱调试说明

业务用例

管理附近推广计划

上传营销图片资源

创建推广计划

接收推广计划变更成功消息

查询推广计划

停止推广

管理全城推广计划

上传营销图片资源

创建推广计划

接收推广计划变更成功消息

查询推广计划

停止推广