更新时间：2025-03-07 14:37:55文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档商家/服务商接入 优惠券 并完成 后，可以使用支付宝提供的 推广 功能将 优惠券 推广至支付宝对外开放的相关曝光渠道 。说明：引流转化 支持自研商家/服务商通过自研、代开发、代运营模式调用 api 接入，各模式配置详情可查看 。1 接入代运营授权适用商家：直连商家。服务商代商家进行推广操作前，需根据商家身份确定是否进行代运营授权，自研商家无需关注。服务商需向商家发起营销代运营授权申请，并获得商家在支付宝上的授权后，服务商才能代商家进行创建营销活动等操作，详情可查看 。注意：代运营授权能力：●支持服务商使用自研应用及第三方应用自调用（即无需传入app_auth_token）方式进行接入。●（向商户发起代运营操作接口）operate_type（操作类型）参数需传入operation_auth（授权操作）类型。2 接入引流转化2.1 接口调用时序图说明：其中商家与服务商的交互流程仅为示意，具体交互方式以服务商实际使用场景为准。2.2 推广计划状态流转图注意：●创建推广之后进入审核中状态，审核结果通过异步消息通知到服务商。●已过期的推广计划会被定期清理进入已失效状态。2.3 第一步：上传图片资料商家/服务商调用 ，将优惠券的配图上传至支付宝获取 resource_id（图片唯一资源 id）用于后续创建推广。注意：●本接口需使用最新版 服务端 sdk，如 java 4.10.1 及以上版本。●上传图片资料时 file_key 固定为public_union_channel_pic。●上传图片尺寸 600 * 600，支持格式：png、jpg、jpeg、bmp，大小不超过 200 kb。更多图片上传要求可查看 素材规范。2.3.1 请求示例带 belong_merchant_info 场景不带 belong_merchant_info 场景2.4 第二步：创建推广计划商家/服务商调用 ，将商家/服务商系统中创建好的 商家券 推广至指定渠道。注意：●推广活动 id，一个活动 id 同一时间仅可创建一个推广计划○活动 id 为优惠券创建时返回的 activityid○目前支持 商家支付券、商家券。●用户领券链接 商家/服务商调用 delivery_guide_url（用户领券链接）来控制用户在支付宝领券时，跳转到商家小程序的页面。delivery_guide_url 必须为创建推广对应商家账号下的小程序 url，且必须符合 小程序scheme链接规范。 ●推广目的 商家支付宝做推广时，支持两种推广方式：○附近发券：根据商户门店位置发券（门店附近 3km），适用于到店点餐、自提、超市等线下场景。 注意：配置附近发券模式优惠券上必须配置门店。○全城发券：指定发券城市，适用于电商、外卖、同城闪送等线上场景。●推广成功后约有半小时延迟才会生效。●本接口仅提交推广计划创建申请，计划创建结果，以 为准，可查看 变更推广状态通知；还可通过 ，传入delivery_id（推广计划 id）查询确认。2.4.1 请求示例第三步：查询推广计划商家/服务商可以调用 ，查询推广计划的详情信息。2.4.2 请求示例2.5 第四步：停止推广计划商家/服务商可调用 ，停止已经推广到指定渠道的推广计划。注意：●调用接口停止推广后，存在 5 ~ 10 分钟延迟才会生效。●已经停止的推广，可以使用 再次将推广生效。2.5.1 请求示例2.6 消息通知商家/服务商创建的审核中推广计划在审核后，支付宝都将通过 向商家应用或第三方应用应用网关推送异步通知消息，同步审核结果。说明：●更多支付宝异步消息通知详情可查看 from 蚂蚁消息服务使用。●若商家/服务商网络环境比较复杂，例如：通过统一网关接入互联网，推荐使用网络兼容性更好的标准 http(s) 协议进行对接。2.6.1 第一步：订阅消息商家/服务商需根据 订阅消息 指引，为接入商家自运营推广的商家应用或第三方应用订阅 。注意：仅完成订阅后才会收到支付宝发送的对应异步通知消息。2.6.2 第二步：验签商家/服务商可使用支付宝 sdk，根据 数据验签 指引，使用应用密钥信息验证异步通知消息来源是否为支付宝。2.6.3 第三步：反馈消息接收结果收到异步通知完成验签后，商家/服务商需返回success表示消息获取成功，支付宝就会停止发送异步通知。如果返回fail或其它值，表示消息获取失败，支付宝会根据 投递重试策略 重新发送消息到应用网关地址。说明：完成异步通知验签时，如果验签成功返回 success，验签失败返回fail，重新接收异步进行处理。响应值描述是否重试fail消息获取失败重试success消息获取成功不重试2.6.4 变更推广状态通知商家/服务商可以监听 ，感知推广计划信息的变更。创建推广的推广计划会进入生效中或者审核中状态，审核中的推广计划在审核之后会通过 触达到 服务商。注意：●变更推广计划通知会在推广计划变更存在变更时发出，包括创建、审核、停止、信息变更等操作生效之后发出。●变更推广计划通知仅包含简单的推广计划变更通知信息，更多推广计划信息需通过 获取。消息示例
