已更新更新时间：2024-10-23 18:09:03文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档完成 接入准备 后，商家和服务商可根据本文指引快速集成 小程序商品。说明：●小程序商品 仅支持自研商家/服务商通过 自研应用 或 第三方应用 代调用（传入 app_auth_token）方式，调用 api 接入。●小程序商品 支持沙箱调试。接入流程接口调用方式重要接口说明查询指定商品营销活动模版信息接口请通过 查询以下属性是否是必填项，当 required=true 时表示以下属性必填；如果 multi 字段为 true 时，需要从 options 字段中获得可选值（value）。属性名属性 key示例值说明商品分期免息期数freefeenums["3", "6"]1请使用字符串列表格式。2"3" 支持 3 期分期免息，"6" 支持 6 期分期免息。支持填写多个免息活动时间activitytime{ "timetype": "long_time", "starttime": "2023-08-22 16:17:55", "endtime": "2101-01-01 16:17:55"}{ "timetype": "short_time", "starttime": "2023-08-22 16:17:55", "endtime": "2023-09-10 16:17:55"}timetype 字段表示免息活动时间类型。 long_time 表示长期有效，此时可以不填 endtime 字段，只需填写 starttime 。short_time 表示短期有效，此时 starttime 和 endtime 必填。商家可通过 查询指定商品营销活动模板信息，后续创建以及修改商品的时候都需要使用商品营销活动模版信息中的属性信息。注意●promotion_type 是营销活动类型，请按照枚举值正确填写。批量创建商品营销活动接口商家可通过 alipay.open.app.itempromoactivity.list.create（批量创建商品营销活动接口）向支付宝提报商品营销活动，创建的结果中会返回创建的总数（total_num）、创建成功的数量（success_num）以及创建失败的商品列表（failed_item_list），其中 failed_item_list 中有每一个创建失败商品的失败原因。注意●针对每一个提报的商品，其 item_id 和 out_item_id 不能同时为空，两者都填时，以 item_id 为准。批量修改商品营销活动接口商家可通过 alipay.open.app.itempromoactivity.list.modify（批量修改商品营销活动信息接口）向支付宝修改商品营销活动，修改的结果中会返回修改的总数（total_num）、修改成功的数量（success_num）以及修改失败的商品列表（failed_item_list），其中 failed_item_list 中有每一个修改失败商品的失败原因。注意●针对每一个修改的商品，其 item_id 和 out_item_id 不能同时为空，两者都填时，以 item_id 为准。批量删除商品营销活动接口商家可通过 alipay.open.app.itempromoactivity.list.delete（批量删除商品营销活动接口）向支付宝删除商品营销活动，删除的结果中会返回删除的总数（total_num）、删除成功的数量（success_num）以及删除失败的商品列表（failed_item_list），其中 failed_item_list 中有每一个删除失败商品的失败原因。注意●针对每一个删除的商品，其 item_id 和 out_item_id 不能同时为空，两者都填时，以 item_id 为准。分页查询商品营销活动信息接口商家可通过 alipay.open.app.itempromoactivity.list.query（分页查询商品营销活动信息接口）向支付宝查询商家在指定营销活动下的商品报名记录。注意●在接口请求参数中，promotion_type 需要按照枚举值正确填写。
