更新时间：2025-03-06 15:12:54文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档商家/服务商完成 后，可通过支付宝的推广能力将配置的 支付券/商家券/小程序服务 推广至支付成功页本店优惠区域。说明：支付有礼 推广能力支持自研商家/服务商通过自研、代开发模式调用 api 接入，各模式配置详情可查看 。1 接入支付有礼1.1 接口调用时序图说明：其中商家与服务商的交互流程仅为示意，具体交互方式以服务商实际使用场景为准。1.2 推广计划状态流转图注意：1推广计划完成创建后进入审核中状态，审核结果通过异步消息通知到商家/服务商。2已过期的推广计划会被定期清理进入已失效状态。1.3 第一步：创建推广计划商家/服务商 调用 ，将商家/服务商 系统中创建完成的 支付券/商家券/小程序服务 推广至支付成功页本店优惠区域。注意：1创建推广 delivery_target_rule#delivery_merchant_rule（指定支付成功页）○选择指定收款账号模式-传入对应的指定收款账号时，将在收款账号对应的支付成功页曝光。上传的收款账号需满足以下条件：■收款账号需为商户同主体的pid/m4，或跨主体授权的pid/m4■收款账号需签约如下支付宝收单产品。 线下支付：转账收款码（transfer_qrcode_pay）、当面付快捷版（offline_payment）、新当面付收单产品（face_to_face_payment）、支付宝当面付（alipay_f2f_payment）、线下条码收单（barcode_pay_offline）、线下扫码支付（qr_code_offline）、 扫码即时到账（paipai_fast_pay ）、线下声波支付（soundwave_pay_offline） 无线支付：快捷手机安全支付（quick_msecurity_pay ）、快捷手机wap支付（quick_wap_way ）、无线下单支付（wap_create_trade） 网站支付：快捷即时到账（fast_instant_trade_pay）、即时到账收款（trade_fast_pay）、大快捷即时到帐收款（quick_trade_fast_pay）、普通银直联收款（puregw_fast_pay） 代扣：商户代扣（general_withholding）、周期扣款（cycle_pay_auth）2创建推广可选delivery_target_rule#delivery_promo_tags（订单优惠标记）○商家在该接口完成订单优惠标记填充后，符合该条件的订单，商家需在调用支付接口（例如 alipay.trade.pay ）创建支付订单时，在隐藏字段“bizcontent#business_params”的子字段“delivery_promo_tags”填充对应的订单优惠标记请求参数名称参数类型是否必填最大长度描述示例值业务拓展参数business_paramsbusinessparams可选商户传入业务信息，应用于营销参数直传场景，格式为json格式订单优惠标记└delivery_promo_tagsstring可选680支付有礼-订单优惠标记，按json格式。1订单优惠标记限制： 单个优惠标最大长度32字节 。多个标记值以英文逗号分隔。 单个优惠标仅支持字母/数字/下划线。2建议订单优惠标记数量控制在20个以内。memberlevel1,memberlevel2○请求示例 3支付有礼支持创建多个优惠券推广计划，算法将根据内容类型、内容领取率为用户推荐其中一个符合的计划，领取率越高，被推广概率越大。如推广的多个内容为同一时间首次投放，则平台会分批次提供冷启动流量4推广计划创建成功后，会进入计划审核流程。工作日提交的计划，预计1个工作日给予审核反馈；非工作日提交的计划，预计2天给予审核反馈。审核结果将通过 反馈至商家/服务商。5推广计划审核通过后，预计5～10分钟后生效。1.3.1 请求示例支付送优惠活动场景满额送优惠活动场景1.4 第二步：查询推广计划商家/服务商 可以调用 ，查询推广计划的详细信息。1.4.1 请求示例1.5 第三步：终止推广计划商家/服务商 可调用 ，终止已经推广到指定渠道的推广计划，且不可恢复。注意：1成功调用接口终止推广后，预计 5 ~ 10 分钟后才会生效。1.5.1 请求示例2 消息通知商家/服务商 成功创建的推广计划，支付宝都将通过 向商家应用或第三方应用 应用网关 推送异步通知消息，同步推广计划的状态变更信息，包括创建、审核、终止等操作的结果反馈。说明：1更多支付宝异步消息通知详情可查看 from 蚂蚁消息服务使用。2若商家/isv 网络环境比较复杂，如：通过统一网关间连互联网，推荐使用网络兼容性更好的标准 http(s) 协议进行对接。3商家/isv可以监听 alipay.marketing.activity.delivery.changed（推广计划状态变更消息接口），感知推广计划信息的变更。创建推广的推广计划会进入生效中或者审核中状态，审核中的推广计划在审核之后会通过 触达到 isv。消息示例2.1 第一步：订阅消息商家/服务商 需根据 订阅消息 指引，为接入支付有礼的 商家应用 或 第三方应用 订阅 alipay.marketing.activity.delivery.changed（推广计划状态变更消息接口）。注意：仅完成订阅后才会收到支付宝发送的对应异步通知消息。2.2 第二步：验签商家/isv 可使用支付宝 sdk 可根据 数据验签 指引，使用应用密钥信息验证异步通知消息来源是否为支付宝。2.3 第三步：反馈消息接收结果收到异步通知完成验签后，商家/isv 需返回 success 表示消息获取成功，支付宝就会停止发送异步通知。如果返回 fail 或其它值，表示消息获取失败，支付宝会根据 投递重试策略 重新发送消息到应用网关地址。说明：完成异步通知验签时，如果验签成功返回 success，验签失败返回 fail，重新接收异步进行处理。响应值描述是否重试fail消息获取失败重试success消息获取成功不重试
