微信支付「积分兑换立减金」产品使用手册

更新时间：2026.05.28

1.产品介绍

「积分兑券」，是微信支付为银行提供的基于积分权益运营的营销应用产品。本质是一个连接商户优惠、微信生态和银行积分系统的桥梁，通过微信的流量和体验优势，帮助银行盘活积分资产。

精准的用户投放能力：支持通过号码包向特定用户群体投放活动
可定制的积分规则：银行可根据自身业务策略灵活配置兑换比例、参与次数等
灵活的对接模式：支持直连与网联模式，覆盖不同银行的技术能力和合规需求

2.产品功能及交互

2.1产品交互图

摇优惠将支持积分兑券形式的投放活动，以适配银行的积分营销诉求，整体兑换流程包含三步：

领取资格：用户在二选一，先领取“积分兑券”资格，包含兑换入口。
在微信内完成兑换：用户点击兑换后，会调起微信原生的窗口进行兑换交互，
商户系统交互与结果返回：用户点击“确认兑换”后，会发起与银行系统的交互，由银行检查积分余额并进行积分扣减，然后返回兑换结果。

银行整体交互图如下：

3.银行接入流程

3.1申请接入

银行邮件发起活动接入申请，需提供如下信息：

邮件名称：【积分兑券】+银行名

收件人：weixinpay_bankmkt@tencent.com

抄送：camiecai@tencent.com

邮件正文：说明业务场景、预计开发启动及完成时间、制券商户号、商户号名称

字段		字段说明
对接方式		选择直连接入/网联对接
银行卡信息	银行名称	活动银行的银行名称
	银行卡类型	选择“储蓄卡”、“信用卡”
	银行层级	选择“总行”、“分行”
	分行信息	-仅银行层级选择“分行”时需填写 -支持选择省+市
系统信息	回调地址url	对接方式为“直连接入”时填写，接收积分兑换事件通知的回调地址 url
系统信息	交互商户号	对接方式为“直连接入”时填写，银行调用积分兑换 api 的商户号

3.2创建&管理活动

3.2.1「自定义号码包」定向用户投放

银行筛选符合投放诉求、且满足积分抵扣条件的用户，参考银行号码包产品介绍创建用户包并上传用户的交易协议号；

3.2.2移除活动目标人群接口

注：因积分资产会随时变动，为提高用户体验，银行侧可通过api剔除“已积分余额不满足要求”或“因其他原因不满足要求”的用户。

预计系统应答后2-3h完成曝光剔除，因此上传的剔除名单与实际剔除成功的名单可能存在一定误差，请知悉！

1）接口调用请求说明

1http请求方式：POST
2https://v3/marketing/bank-points/activity/{activity_id}/users/remove

2）请求参数说明

参数名	类型	是否必填	参数描述
activity_id	string	是	希望剔除用户的活动id
contract_id	string	是	希望剔除的用户对应的协议号id

3）请求参数示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/marketing/bank-points/activity/activity_id_example/users/remove \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "contract_id" : [
8      "example_contract_id"
9    ]
10  }'

4）应答参数说明

参数	类型	是否必填	说明
activity_id	string	否	剔除完毕的活动id

5）应答示例

1{
2  "activity_id" : "example_activity_id"
3}

6）业务错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅基本规则
401	SIGN_ERROR	验证不通过	请参阅为什么请求返回401 Unauthorized？
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

3.2.3创建活动

1）商户平台管理端

前往商户平台登录商户号，访问积分当钱花活动页面（页面链接逐步开放中，可咨询对接的微信支付运营人员获取）

点击创建活动，即可配置活动信息，可在右侧预览效果，字段填写规则详情可见下方表格

活动创建完成后，可访问活动详情页，查看具体信息

2）活动创建所需字段说明

模块	字段	必填/选填	字段说明
基础信息	活动名称	必填	用于商户管理的活动名称，不对C展示 -支持中文、英文、数字、特殊符号； -限制 50 字符
	活动银行	必填	仅支持选择「银行系统管理端」登记的银行
	银行卡类型	必填	-单选，支持选择储蓄卡/信用卡 -仅支持选择活动银行在「银行系统管理端」登记的卡类型，即中国银行仅登记了“信用卡”的系统交互信息，则支持选择信用卡
	活动出资行	必填	-单选，支持选择总行/分行 -仅支持选择活动银行在「银行系统管理端」登记的出资行类型，即中国银行仅登记了“深圳市分行”的系统交互信息，则支持选择“分行”
	分行地区	选填	-若银行层级选择分行，则需选择省份和城市 -仅支持选择活动银行在「银行系统管理端」登记的分行地区，即中国银行仅登记了“深圳市分行”的系统交互信息，则支持选择“广东省-深圳市”
	银行卡BIN	选填	-支持选择限制/不限制 -选择限制时，支持填写卡 bin； -仅支持填写数字； -校验卡 bin 与银行类型的匹配性其他校验条件与多笔立减活动创建一致
	卡片名称	选填	-选择限制时，支持填写卡片名称； -仅支持填写中文&英文其他校验条件与多笔立减活动创建一致
优惠规则	优惠类型	-	本期仅支持“立减金”，后续可能扩展支持“多笔立减”
	兑换规则	-	本期仅支持“定额兑换”，后续可能扩展支持“比例抵扣”
	积分消耗数	必填	优惠获取所需消耗的积分数可指定 1-10000数值；
	积分消耗原价	选填	若微信支付渠道积分价格低于其他渠道，可填写其他渠道的积分原价可指定 1-10000数值；需高于“积分消耗数；为防止夸张优惠幅度，限制“积分原价/积分消耗数≤10”
	优惠金额	必填	立减金满减规则中的“优惠金额”，即满15可减10元中的“减10元” -仅支持填写数字，单位为元 -最少金额为 1 元 -门槛金额不支持自定义，根据优惠金额取最小值，即优惠金额为 1 时，门槛金额默认为 1.01 元
	积分退还规则	-	默认要求为“逾期未核销自动退回积分”
	叠加使用规则	-	后台配置支持选择：1、可以和其他优惠同时使用；2、不可以和本商户号创建的其他立减/折扣同时使用；3、不可以和任意优惠券、立减/折扣同时使用； -本期仅支持选择“可叠加使用”，b 端展示为固定文案不可选； -即同银行同类型的立减金可在一笔支付中叠加使用；
活动规则	可领券时间	必填	活动有效时间，即用户可领券的时间范围 -时间选择精确到日 -起始时间必须大于当前时间 -结束时间需晚于起始时间 -可领券时间周期最小为15天，最长为 180 天
	兑换后可核销期限	必填	领券后用户可用核销的时间范围 -支持填写数值，单位为天 -最小为15天，最长为 180 天
	资金模式	-	本期仅支持预充值模式，b 端仅展示
	活动总预算	必填	活动的总预算金额，核销消耗完成后，不再发券 -仅支持填写正整数，需＞0
	单日发放预算	选填	单日发券（不是兑换/核销）累计的优惠金额达到上限后，该批次被过滤，不会再有新用户可领券，摇优惠不再向用户曝光 -可选择限制/不限制支持填写正整数，单位为元；数值需>0，小于总预算；
	单用户可领次数上限	选填	单用户在活动运行时间周期内，领券次数达到上限时，此批次不再向该用户曝光，用户不再可领 -可选择限制/不限制支持填写正整数，单位为次； -数值需≥1
	单用户单日可领次数上限	选填	单用户单日领券次数达到上限时，此批次不再向该用户曝光，用户不再可领 -可选择限制/不限制支持填写正整数，单位为次； -数值需≥1，小于单用户可领次数上限
	兑券说明跳转appid	选填	1、券详页积分兑换说明模块，可配置appid跳转到银行小程序，用于引导用户查看积分余额等信息； 2、获取方式包括“消耗资产获取”、“指定门槛获取”时，选填
	兑券说明跳转path	选填	1、兑券说明 appid 对应 path； 2、获取方式包括“消耗资产获取”、“指定门槛获取”时，选填
投放配置	投放人群圈选模式		本期仅支持选择「银行号码包」
投放配置	号码包ID		选择「银行号码包」模式时支持选择号码包ID 选择号码包 id 范围，需根据号码包授权使用商户号范围筛选

3.2.4活动管理流程

3.3用户积分兑换流程API交互

将通过直连与网联两种对接模式实现系统交互与业务实现。

3.3.1直连银行模式

详见业务说明文档：银行积分兑立减金API文档

3.3.2网联对接银行

详见网联技术文档：

Q-NUC XXX.x-YYYY 营销平台报文交换技术规范（2024D 分期计费能力支持试行稿).pdf附件1：Q-NUC 102-2024 网络支付清算平台报文交换技术规范（2024版） (2)(6).pdff

文档是否有帮助