商家/服务商完成接入准备后，可通过支付宝的带货能力将配置的支付券/商家券在消息的指定区域呈现。

说明：消息运营 能力支持自研商家/服务商通过自研、代开发模式调用 API 接入，各模式配置详情可查看接入准备。

第一步：完成消息接入

此步骤若已完成可跳过。

根据实际业务场景，选择接入订阅消息或订单消息，按照权限集介绍完成消息接入。

第二步：接入商家券/配置支付券

此步骤若已完成可跳过。

商家券接入可查看商家券产品介绍。

支付券接入可查看支付券产品介绍。

第三步：管理消息运营信息

接口调用时序图

**说明：**其中商家与服务商的交互流程仅为示意，具体交互方式以服务商实际使用场景为准。

运营计划状态流转图

第一步：创建消息运营

商家/服务商调用alipay.marketing.activity.delivery.create（创建推广计划），将商家/服务商系统中创建完成的支付券/商家券在消息指定区域运营。

说明：

消息运营目前仅支持商家券、支付券生成的优惠券。

template_id（消息模板 id）可通过 alipay.open.mini.message.template.batchquery（消息子板批量查询接口）获取。

pid（收款账号）可通过 ant.merchant.expand.apprecommend.account.query（查询已关联指定APP的账号列表）获取。

运营计划创建成功后，预计 5～10 分钟后可在指定的消息区域呈现关联的优惠券。

第二步：查询运营计划

商家/服务商可以调用 alipay.marketing.activity.delivery.query（查询推广计划），查询运营计划的详细信息。

第三步：终止运营计划

商家/服务商可调用 alipay.marketing.activity.delivery.stop（停止推广计划），终止已生效的运营计划，且不可恢复。

**说明：**成功调用接口终止运营计划后，预计 5 ~ 10 分钟后生效。

消息通知

商家/服务商成功创建的运营计划，支付宝都将通过 alipay.marketing.activity.delivery.changed（推广计划状态变更消息）向商家应用或第三方应用应用网关推送异步通知消息，同步运营计划的状态变更信息，包括创建、终止等操作的结果反馈

说明：

更多支付宝异步消息通知详情可查看 From 蚂蚁消息服务使用。

若商家/服务商网络环境比较复杂，如：通过统一网关间连互联网，推荐使用网络兼容性更好的标准 HTTP(S) 协议进行对接。

商家/服务商可以监听 alipay.marketing.activity.delivery.changed（运营计划状态变更消息接口），感知运营计划信息的变更。

第一步：订阅消息

商家/服务商需根据订阅消息指引，为接入搜索直达的 商家应用 或 第三方应用 订阅 alipay.marketing.activity.delivery.changed（运营计划状态变更消息接口）。

**注意：**仅完成订阅后才会收到支付宝发送的对应异步通知消息。

第二步：验签

商家/服务商可使用支付宝 SDK 可根据数据验签指引，使用应用密钥信息验证异步通知消息来源是否为支付宝。

第三步：反馈消息接收结果

收到异步通知完成验签后，商家/服务商需返回 success 表示消息获取成功，支付宝就会停止发送异步通知。如果返回 fail 或其它值，表示消息获取失败，支付宝会根据投递重试策略重新发送消息到应用网关地址。

**说明：**完成异步通知验签时，如果验签成功返回 success，验签失败返回 fail，重新接收异步进行处理。

响应值	描述	是否重试
fail	消息获取失败	重试
success	消息获取成功	不重试

消息运营计划接入指南

第一步：完成消息接入#

第二步：接入商家券/配置支付券#

第三步：管理消息运营信息#

接口调用时序图#

运营计划状态流转图#

第一步：创建消息运营#

第二步：查询运营计划#

第三步：终止运营计划#

消息通知#

第一步：订阅消息#

第二步：验签#

第三步：反馈消息接收结果#