摇优惠开发指引

更新时间：2025.08.18

一、整体开发流程概览

1、【必需接入】摇优惠接入

“摇一摇有优惠”是微信支付推出的一种互动营销功能，基于用户在微信支付的消费偏好，向用户提供优惠发放和核销的服务。商家需完成摇优惠商家券接入、活动测试、活动投放这3个步骤才能正式上线摇优惠活动。

步骤说明

步骤	步骤名称	步骤说明
1	摇优惠商家券接入	商家券是微信支付为商户提供的电子优惠券全链路解决方案，支持商户通过API接口实现优惠券的创建、领取、通知、核销，券信息查询等配套功能完成商家券的管理操作。详细指引请参考：商家券接口接入说明
2	摇优惠活动测试	商家完成摇优惠商家券功能开发后，为确保功能正常运行需进行摇优惠活动的测试。通过测试帮助开发者和运营人员在上线前完成系统联调和功能验证。详细指引请参考：摇优惠活动测试指引
3	摇优惠活动投放	商家完成活动测试后需通过活动投放正式上线摇优惠活动。详细指引请参考：摇优惠活动投放

2、【按需接入】核销组件接入

为解决在摇一摇有优惠场景“由于用户在商家小程序未登录正确的领券账号，导致无法找到优惠券”和“用户领取优惠券后在商家小程序未能找到优惠券适用的商品”这两大核心问题，平台侧提供标准化核销组件，用于提升用户领券率与领取核销率。

核销组件接入指引请参考：核销组件开发指引
完成核销组件开发后，需对摇优惠活动重新进行测试，详细指引请参考：摇优惠活动测试指引

注意

目前从微信卡包页面点击微信卡券的“立即使用”跳转不会携带核销组件的参数，商户只有接入核销组件且从摇一摇会场“去小程序使用”跳转才会携带核销组件的参数，商户侧需要做兼容处理。

3、【按需接入】品牌门店接入

品牌录入门店后可以在开展摇一摇有优惠活动时，基于门店位置更精准地投放商品券，提升领券转化率，从而提升品牌和活动可拿到的曝光量。

品牌方案，是微信支付为「连锁经营品牌商家」定制的行业解决方案。方案基于“品牌-门店”的商业关系，向连锁经营品牌商家提供进件、交易场景配置、流量开放、资金管理、数据管理、营销管理等场景的专项解决方案。

商户可以选择以下任意一种方式对品牌门店进行管理：

商户平台管理：操作指引详见：品牌-门店关系管理
API管理：接入指引详见：摇优惠-品牌门店开发指引

注意

接入品牌后，面向交易用户的收银台、支付完成页、支付凭证、交易账单将优先展示品牌名称和品牌logo，接入前请详细了解面向交易用户展示品牌信息的相关规则

4、【按需接入】摇优惠活动验收

商家运营人员如需对已开发的产品能力做验收，可根据摇优惠活动验收指引中测试用例进行逐项验收。

二、附录

商家券接口接入说明

类型	接口名	注意事项
必须接入	创建商家券（普通商户 \| 服务商）	满足以下条件的券批次才可创建「摇一摇有优惠」活动，商家侧需要做兼容处理：【批次类型】若摇优惠活动为单品类型（例如单个商品优惠，或N个商品多选一优惠），则商家券批次类型必须是换购券(EXCHANGE)。若是全场类型活动，则商家券批次类型必须是固定面额满减券（NORMAL）或折扣券（DISCOUNT）。【发放规则】券的批次剩余个数stock_send_rule.max_coupons需>=1万。【发放规则】不允许设置stock_send_rule.max_coupons_by_day单天发放个数限制。【核销规则】核销方式coupon_use_rule.use_method必须为线上小程序核销（MINI_PROGRAMS）。【券code模式】创建商家券批次时目前仅支持系统分配code模式（WECHATPAY_MODE）和预存code模式（MERCHANT_UPLOAD），不支持商户发放时指定券code模式。（MERCHANT_API）。【事件通知配置】notify_config.notify_appid字段为必填项，用于回调通知时，计算返回操作用户的OpenID（领券用户），支持小程序or公众号的AppID。
	设置商家券事件通知地址（普通商户 \| 服务商）	仅可以收到由商户自己创建的批次相关的通知。需要设置apiv3密钥，否则无法收到回调。如果需要领券回调中的参数OpenID。需要创券时候传入notify_appid参数。如商户多个业务公用一个通知地址，商户需自行做好不同业务回调通知的逻辑处理（可基于回调通知类型（event_type）区分）。
	根据过滤条件查询用户的券（普通商户 \| 服务商）	可通过该接口查询指定微信用户卡包中满足对应条件的所有商家券信息。
	核销用户的券（普通商户 \| 服务商）	核销接口传入的单号需要与实际支付时下单的单号保持一致。若商家的使用场景涉及品牌门店时，建议在对应的下单接口（例如JSAPI支付/小程序支付/APP支付/H5支付）回传门店信息到store_info字段中。如何获取有关的门店信息可参考：摇优惠-品牌门店开发指引。如果通过微信支付分核销，核销时不能传入支付分服务单号，可在支付分扣款成功后，通过支付成功回调和查询支付分订单获取微信支付订单号transaction_id。已核销的券，可通过查询用户券详情和根据过滤条件查询用户的券查询核销传入的订单号。
	领券事件回调通知（普通商户 \| 服务商）	当商户接收到领券事件回调通知后，商户系统需给用户发放商家券。如需测试回调通知/摇一摇逻辑，需要实现全部接口逻辑后，找对接的运营同事协助代发起摇一摇测试活动，体验摇一摇领券。需要按照回调通知注意事项进行回调通知的处理。
	查询商家券批次详情（普通商户 \| 服务商）	可通过该接口查询已创建的商家券批次详情信息。
按需接入	修改批次预算（普通商户 \| 服务商）
	修改商家券基本信息（普通商户 \| 服务商）
	申请退券（普通商户 \| 服务商）
	上传预存code（普通商户 \| 服务商）	当券在发放时，微信支付自动从已导入的code中随机取值（不能指定），派发给用户。
	向用户发放商品券（普通商户 \| 服务商）
	查询用户券详情（普通商户 \| 服务商）
	获取商家券事件通知地址（普通商户 \| 服务商）
	使券失效（普通商户 \| 服务商）	失效接口仅支持单个批次和单个券code码。如果需要失效多个批次的券code码，商家需进行多次请求。
	图片上传（营销专用）（普通商户 \| 服务商）

详细开发指引请参考：摇优惠-商家券开发指引

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服

类型	接口名	注意事项
必须接入	创建商家券（普通商户 \| 服务商）	满足以下条件的券批次才可创建「摇一摇有优惠」活动，商家侧需要做兼容处理：【批次类型】若摇优惠活动为单品类型（例如单个商品优惠，或N个商品多选一优惠），则商家券批次类型必须是换购券(EXCHANGE)。若是全场类型活动，则商家券批次类型必须是固定面额满减券（NORMAL）或折扣券（DISCOUNT）。【发放规则】券的批次剩余个数stock_send_rule.max_coupons需>=1万。【发放规则】不允许设置stock_send_rule.max_coupons_by_day单天发放个数限制。【核销规则】核销方式coupon_use_rule.use_method必须为线上小程序核销（MINI_PROGRAMS）。【券code模式】创建商家券批次时目前仅支持系统分配code模式（WECHATPAY_MODE）和预存code模式（MERCHANT_UPLOAD），不支持商户发放时指定券code模式。（MERCHANT_API）。【事件通知配置】notify_config.notify_appid字段为必填项，用于回调通知时，计算返回操作用户的OpenID（领券用户），支持小程序or公众号的AppID。
	设置商家券事件通知地址（普通商户 \| 服务商）	仅可以收到由商户自己创建的批次相关的通知。需要设置apiv3密钥，否则无法收到回调。如果需要领券回调中的参数OpenID。需要创券时候传入notify_appid参数。如商户多个业务公用一个通知地址，商户需自行做好不同业务回调通知的逻辑处理（可基于回调通知类型（event_type）区分）。
	根据过滤条件查询用户的券（普通商户 \| 服务商）	可通过该接口查询指定微信用户卡包中满足对应条件的所有商家券信息。
	核销用户的券（普通商户 \| 服务商）	核销接口传入的单号需要与实际支付时下单的单号保持一致。若商家的使用场景涉及品牌门店时，建议在对应的下单接口（例如JSAPI支付/小程序支付/APP支付/H5支付）回传门店信息到store_info字段中。如何获取有关的门店信息可参考：摇优惠-品牌门店开发指引。如果通过微信支付分核销，核销时不能传入支付分服务单号，可在支付分扣款成功后，通过支付成功回调和查询支付分订单获取微信支付订单号transaction_id。已核销的券，可通过查询用户券详情和根据过滤条件查询用户的券查询核销传入的订单号。
	领券事件回调通知（普通商户 \| 服务商）	当商户接收到领券事件回调通知后，商户系统需给用户发放商家券。如需测试回调通知/摇一摇逻辑，需要实现全部接口逻辑后，找对接的运营同事协助代发起摇一摇测试活动，体验摇一摇领券。需要按照回调通知注意事项进行回调通知的处理。
	查询商家券批次详情（普通商户 \| 服务商）	可通过该接口查询已创建的商家券批次详情信息。
按需接入	修改批次预算（普通商户 \| 服务商）
	修改商家券基本信息（普通商户 \| 服务商）
	申请退券（普通商户 \| 服务商）
	上传预存code（普通商户 \| 服务商）	当券在发放时，微信支付自动从已导入的code中随机取值（不能指定），派发给用户。
	向用户发放商品券（普通商户 \| 服务商）
	查询用户券详情（普通商户 \| 服务商）
	获取商家券事件通知地址（普通商户 \| 服务商）
	使券失效（普通商户 \| 服务商）	失效接口仅支持单个批次和单个券code码。如果需要失效多个批次的券code码，商家需进行多次请求。
	图片上传（营销专用）（普通商户 \| 服务商）