接入指南
完整接口时序图
接入支付宝门店（可选）
接入支付券
创建支付券
voucher_display_info#voucher_image（券详情页封面图）对应 file_key 为 PROMO_VOUCHER_IMAGE ，voucher_display_info#voucher_detail_images (券详细图列表) 对应 file_key 为 PROMO_VOUCHER_DETAIL_IMAGE。voucher_use_rule#voucher_valid_period（日期区间内可以使用优惠）参数控制：[ valid_begin_time,valid_end_time ] 区间为准。[ event_time + wait_days_after_receive,event_time + wait_days_after_receive + valid_days_after_receive ]。激活支付券
voucher_budget_supply_info.budget_type = RECHARGE 预充值，调用 alipay.marketing.activity.voucher.publish（激活支付券）会返回充值链接 ，制券方需点击此链接完成充值（充值链接有效期 3 天，超期未支付需重新调用激活接口获取新充值链接）。展示效果
管理支付券活动
修改支付券
shop_ids（门店列表）修改时才允许修改门店，创建时未配置 shop_ids（门店列表）修改时不允许修改门店。shop_ids（门店列表）只允许增加不允许减少。传入本参数后支付宝将在已有门店列表基础上去重、新增，未传本参数则保持不变。券核销规则中的支付券可使用范围。publish_end_time（券发放结束时间）只能延期，不能提前结束。追加预算
voucher_quantity 表示追加以后的券的总数量。例如，活动本来发放 200 张券，现需追加 100 张，总共发放 300 张券，则 voucher_quantity 应传入 300。voucher_budget_supply_info.budget_type = RECHARGE 预充值，调用 alipay.marketing.activity.voucher.append（追加支付券预算）会返回充值链接 ，制券方需点击此链接完成充值（充值链接有效期 3 天，超期未支付需重新调用追加预算接口获取新充值链接）。voucher_send_rule_info#quantity 查看券活动总数量。终止发券
FINISHED（已停止）。推广支付券
领取券
领取支付券
用户端流程示例
核销支付券
消息通知
第一步：订阅消息
msg_method 参数判断消息类型。| **消息接口（**英文/中文名） | 作用 |
|---|---|
| alipay.marketing.activity.message.created（券活动创建通知） | 同步支付券活动发布结果。 |
| alipay.marketing.activity.message.modified（券活动修改通知） | 同步支付券活动修改结果。 |
| alipay.marketing.activity.message.appended（券活动预算追加通知） | 同步支付券活动预算追加结果。 |
| alipay.marketing.activity.message.stopped（券活动停止通知） | 同步支付券活动终止结果。 |
| alipay.marketing.activity.message.received（券领取通知） | 同步支付券用户领取结果。 |
| alipay.marketing.activity.message.used（券核销消息） | 同步支付券用户核销结果。 |
第二步：验签
第三步：反馈消息接收结果
success 表示消息获取成功，支付宝就会停止发送异步通知。如果返回 fail 或其它值，表示消息获取失败，支付宝会根据 投递重试策略 重新发送消息到应用网关地址。success，验签失败返回 fail，重新接收异步进行处理。| 响应值 | 描述 | 是否重试 |
|---|---|---|
| fail | 消息获取失败 | 重试 |
| success | 消息获取成功 | 不重试 |
支付券消息通知
活动发布通知
消息示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"id":"CREATED_2021042400826001508407723739","activity_id":"2016042700826004508401111111","event_time":"12342425435232423","out_biz_no":"abscd123341"
}
&msg_method=alipay.marketing.activity.message.created&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==追加预算通知
消息示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"id":"APPENDED_2021042400826001508407723739","activity_id":"2016042700826004508401111111","event_time":"1619338271","out_biz_no":"20210420cy2112xzyx010"
}
&msg_method=alipay.marketing.activity.message.appended&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==活动修改通知
消息示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"id":"MODIFIED_2021042400826001508407723739","activity_id":"2016042700826004508401111111","event_time":"1619338271","out_biz_no":"abscd123341"
}
&msg_method=alipay.marketing.activity.message.modified&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==领取通知
user_id（支付宝用户 ID）、voucher_id（优惠券ID）等信息给商家/服务商。消息示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"id":"RECEIVED_2021042400826001508407723739","activity_id":"2016042700826004508401111111","event_time":"1619338271","voucher_id":"voucher_id","receive_user_id":"2088xxxxx"
}
&msg_method=alipay.marketing.activity.message.received&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==活动终止通知
消息示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"id":"STOPPED_2021042400826001508407723739","activity_id":"2016042700826004508401111111","event_time":"12342425435232423","out_biz_no":"abscd123341"
}
&msg_method=alipay.marketing.activity.message.stopped&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==