【工作相关】商圈积分交易通知+会员与微信/支付宝ID的绑定方案
商圈积分交易通知+会员与微信/支付宝ID的绑定方案
**适用场景:**租户自收银、资金不进商场、租户贴原生静态收款码、商场侧只通过商圈交易通知发放积分;当前只有微信小程序,没有支付宝小程序。
**核心结论:**微信支付 openid 在微信小程序内通过商圈积分插件完成事前绑定;支付宝 buyer_id 受生态隔离限制,无法在微信小程序内获取,需要在支付宝 App 内打开 H5 网页完成授权绑定;两套绑定共用一张 member_pay_account_bind 表,CRM 会员以手机号为唯一主键。
一、方案总体约束与边界
1.1 业务背景
商场入驻微信商圈、支付宝商圈,获取商圈 ID 与门店档案。
租户使用自己的微信商户号、支付宝 PID 收款,资金直入租户账户,商场不碰资金、不做二清。
商场只接收商圈推送的交易通知,按规则向顾客发放积分。
租户收银侧不改码、不改收银系统,使用原生静态收款码。
1.2 关键认知(必须先对齐)
商圈回调报文本身不包含商场会员号、手机号、CRM ID,只包含支付侧交易信息与付款人平台唯一标识(微信 openid / 支付宝 buyer_id)。
会员识别逻辑完全在商场积分中台,通过”支付唯一标识 ↔ CRM 会员”的绑定关系表做二次映射。
绑定关系不是商圈自动给的,必须由顾客主动授权、商场系统主动获取支付标识后入库建立。
杜绝冒领:不开放”手动输入交易单号认领订单”入口,绑定动作必须在付款账号本人的微信/支付宝环境内完成,并做付款账号身份强校验。
1.3 生态隔离硬限制
| 能力 | 微信生态(微信小程序内) | 支付宝生态 |
|---|---|---|
| 获取微信支付 openid | ✅ 支持,通过微信商圈”会员快速积分”官方插件授权回调获得 | ❌ 不支持,无法跨生态调用微信接口 |
| 获取支付宝 buyer_id(2088 开头) | ❌ 不支持,微信小程序内无法拉起支付宝 OAuth,也拿不到支付宝用户标识 | ✅ 支持,需要支付宝小程序或支付宝网页应用(H5 OAuth) |
| 顾客可用载体 | 微信小程序(已具备) | 支付宝 App 内 H5 网页(需新建支付宝开放平台网页应用) |
二、整体流程架构
下图为会员绑定与积分发放的端到端流程,包含事前绑定链路与事后商圈回调匹配链路:
三、微信支付 openid 绑定流程
该链路在已有的微信小程序内完成,是主推的无感积分方案。
3.1 前置准备
商场已入驻微信商圈,创建商圈 ID 与门店档案。
微信小程序引入官方”商圈会员快速积分”插件。
配置插件授权回调地址(商场中台 HTTPS 接口)。
3.2 绑定步骤
顾客在微信小程序内通过手机号验证码登录 CRM,拿到
crm_member_id。进入”商圈积分”页面,加载商圈积分插件,顾客主动授权商圈积分服务。
微信服务器回调商场中台配置的授权通知地址,推送商圈支付域 openid(与后续商圈交易通知报文里的 openid 同源)。
中台校验唯一约束:该 openid 是否已绑定其他会员;若已绑定则拒绝并提示。
写入绑定表:
crm_member_id + pay_channel=1 + pay_account_id=支付 openid。
最高频坑点:openid 三者隔离
小程序 wx.login 拿到的 openid、公众号 openid、商圈支付域 openid 是三套独立体系,不能混用。绑定表只能存商圈插件回调推送的”支付域 openid”,否则商圈交易通知过来一定匹配不到会员。
四、支付宝 buyer_id 绑定方案(重点:仅微信小程序)
4.1 为什么不能在微信小程序里做
微信小程序环境与支付宝生态完全隔离,无法拉起支付宝 OAuth 授权。
没有正规接口可以在微信小程序内获取支付宝 buyer_id。
如果做”输入框让用户手动填 2088 开头 buyer_id”,会带来冒领、刷单风险,明确禁止。
4.2 推荐方案:支付宝网页应用(H5 OAuth)
在支付宝开放平台注册一个网页应用(不是小程序),申请 auth_base 静默授权权限,备案域名,配置 OAuth 回调地址。开发成本远低于支付宝小程序,是当前场景下的最优解。
绑定完整链路
前置:支付宝开放平台创建网页应用,申请用户信息授权(user_id)权限,配置业务域名与授权回调地址。
触达入口:顾客在租户门店用支付宝付款后,支付宝商圈推送服务通知到顾客的支付宝消息列表,通知里的跳转链接指向商场的 H5 绑定页。
顾客在支付宝 App 内点开这条通知,H5 页面通过支付宝 OAuth 静默授权拿到
auth_code。商场后端用
auth_code换取 access_token,进而拿到buyer_id(2088 开头)。H5 页面引导顾客用手机号验证码登录 CRM(与微信小程序是同一套会员池,手机号即会员唯一键)。
**防冒领强校验(核心):**比对当前 OAuth 拿到的 buyer_id 与商圈服务通知里记录的付款 buyer_id 是否一致;不一致直接拦截,提示”非本笔订单付款账号,无法绑定”。
唯一性判断:该 buyer_id 是否已绑定其他会员;未绑定则写入同一张绑定表:
crm_member_id + pay_channel=2 + pay_account_id=buyer_id。绑定成功后,后续该支付宝账号在任何租户门店消费,支付宝商圈回调推送 buyer_id,中台查表匹配会员,自动发放积分。
**防冒领原理:**绑定入口只出现在付款人自己支付宝收到的服务通知里;H5 页面强校验”当前 OAuth 账号 == 流水里的付款账号”。即使顾客把链接转发给别人,别人用自己的支付宝打开,buyer_id 对不上,直接拦截。
4.3 会员池打通
CRM 会员主表以手机号为唯一主键,不要以微信小程序 openid 作为会员主键。
微信小程序登录(手机号验证码)与支付宝 H5 登录(手机号验证码)识别为同一会员。
同一个会员可以在绑定表里有多条记录:一条微信 openid、一条支付宝 buyer_id,甚至多个微信账号。
4.4 备选兜底(不推荐)
如果连支付宝网页应用都暂时不想申请,只能走人工兜底:顾客联系商场客服,提供支付宝订单截图 + 手机号,运营后台人工核验流水后在管理后台录入 buyer_id 绑定。缺点是人工成本高、客诉多,不适合量大的商场。
五、绑定表设计
微信与支付宝共用同一张绑定表,通过 pay_channel 字段区分渠道。
1 | CREATE TABLE `member_pay_account_bind` ( |
5.1 核心约束
| 约束 | 说明 |
|---|---|
唯一索引 uk_channel_pay_account |
同一个支付 ID(同一渠道)只能绑定一个 CRM 会员,防止一笔付款同时匹配到多个会员导致积分多发资损。 |
| 一个会员可绑多个支付账号 | 一个 crm_member_id 可以对应多行记录(微信 A、微信 B、支付宝 C),通过 idx_crm_member_id 索引查询。 |
| 软删除原则 | 解绑不物理删除记录,只更新 bind_status=2 与 unbind_time,保留历史链路用于对账、客诉追溯。 |
5.2 商圈回调匹配会员的 SQL
1 | SELECT crm_member_id |
六、商圈交易通知报文与会员匹配
核心结论:微信商圈、支付宝商圈的交易通知(回调报文)本身不包含商场会员 ID、手机号、CRM 会员编号,只包含支付侧交易信息 + 付款人平台唯一标识(微信 openid / 支付宝 buyer_id);会员匹配是商场积分中台做二次映射,不是商圈直接传会员信息。
6.1 报文字段速览
微信商圈 TRANSACTION_NOTIFY
mch_id:租户微信商户号transaction_id:微信支付单号(幂等键)out_trade_no:租户订单号openid****:付款人支付域 openid(会员匹配核心)total_amount:金额(分)trade_state:SUCCESS / REFUNDstore_id:商圈门店 ID
支付宝商圈 alipay.merchant.trade
pid:租户支付宝 PIDtrade_no:支付宝交易号(幂等键)out_trade_no:商户订单号buyer_id****:2088 开头买家 ID(会员匹配核心)total_amount:金额(元)trade_status:TRADE_SUCCESS / TRADE_REFUNDstore_id:商圈门店 ID
6.2 微信商圈完整报文示例(TRANSACTION_NOTIFY)
商圈事件推送(非普通支付回调),核心字段完整示例如下:
1 | { |
匹配会员唯一标识:openid(支付域 openid)。该 openid 与普通小程序 wx.login 的 openid、公众号 openid 三者互相隔离,不能混用。
6.3 支付宝商圈完整报文示例(alipay.merchant.trade)
1 | { |
匹配会员唯一标识:buyer_id(2088 开头支付宝用户唯一编号)。buyer_id 不是手机号,支付宝不会在报文中返回买家手机号。
**说明:**微信 custom_info / 支付宝 passback_params 只有租户收银系统主动上送才会有值;租户贴原生静态收款码时这两个字段为空。
6.4 报文 → CRM 会员 完整匹配链路
以下为自收银静态码方案(主推)的完整匹配链路:
**接收并验签:**中台接收商圈回调,第一步验签(防止伪造请求刷积分,必做)。
**校验交易状态:**仅成功交易、退款事件进入业务逻辑;过滤关闭、支付失败等无效状态。
**幂等控制:**以平台交易单号
transaction_id / trade_no作为唯一键,防止商圈重复推送回调重复发积分。**提取标识:**微信取
openid,支付宝取buyer_id。**查询绑定表:**查
member_pay_account_bind,命中crm_member_id。**分支处理:**命中则调用 CRM 发放积分,并把交易单号写入积分流水做幂等;未命中则落待绑定流水、不自动发积分(兜底见 6.5)。
**退款匹配:**退款事件通过原交易单号找到原积分流水,定位会员后执行积分回滚;若积分已核销,生成负积分或人工工单。
会员匹配 SQL(高频查询):
1 | SELECT crm_member_id |
**备选链路(收银改造透传模式):**报文 custom_info / passback_params 预先由租户收银塞入 crm_member_id,回调直接解析透传参数即可匹配会员,不再走 openid/buyer_id 查表。局限:静态贴纸收款码不支持,租户必须改收银系统。
6.5 匹配过程中的边界与异常处理
| 边界 / 异常 | 处理方案 |
|---|---|
| openid 混淆(微信最高发) | 小程序/公众号/支付三种 openid 隔离;绑定表只能存商圈支付域 openid,否则商圈回调一定匹配不到会员。 |
| 一个支付账号只绑一个会员 | 唯一索引 uk_channel_pay_account 约束;A 微信已绑会员1,不能再绑会员2。 |
| 报文不带手机号 | 平台不返回买家手机号,禁止通过手机号反向匹配支付账号(违规)。 |
| 退款匹配 | 退款事件报文同样携带 openid/buyer_id + 原交易单号,通过原单号找到积分流水定位会员扣回积分。 |
| 门店归属校验 | 报文带 store_id,中台维护 store_id ↔ 租户商户号映射,防止 A 店交易算到 B 店积分规则。 |
| 未命中会员 | 落待绑定流水,不自动发积分;支付宝侧由商圈服务通知引流到 H5 绑定后补发。 |
七、注意事项与风险点
7.1 最高优先级(资金与合规)
**资金隔离红线:**本方案只做交易消息同步,商场不得截留、划转租户资金,不得修改租户结算路径,避免二清风险。
**商户自愿授权:**租户有权拒绝加入商圈,不能强制圈店;合同需写明授权范围仅限推送交易通知用于积分。
**幂等防重:**商圈回调会重复推送,必须以平台交易单号做唯一键,同一笔订单只发一次积分。
**退款积分回滚:**必须订阅退款事件,退款自动扣回已发积分;积分已核销时要走负积分或人工工单。
7.2 技术与稳定性
**验签不可省略:**所有回调报文必须验签。
**不能只依赖回调:**回调存在超时、丢消息,必须每日定时拉取平台官方流水做补偿补发。
**商户号状态监控:**租户商户号一旦风控冻结、注销或解绑商圈,消息会断流,需要告警。
**门店映射:**报文带 store_id,中台维护 store_id ↔ 租户商户号映射,避免 A 店交易算到 B 店积分规则。
7.3 会员识别相关
**禁止手动输入交易单号认领:**冒领风险高,已在本方案中明确废弃。
**禁止手动输入 buyer_id:**同上,所有 buyer_id 必须来自支付宝 OAuth 授权。
**openid 同源校验:**微信绑定表只存商圈插件推送的支付域 openid,禁止用
wx.login的小程序 openid 入库。**手机号即会员主键:**微信小程序与支付宝 H5 共用一套 CRM,避免出现两个会员。
**隐私合规:**绑定表只存 openid / buyer_id,不存手机号明文;回调报文不会、也不应尝试反查买家手机号。
7.4 运营与对账
三套账要对平:微信/支付宝商圈流水、商场积分发放记录、租户收银账单。
所有回调报文、验签结果、积分发放、退款回滚日志至少保存 6 个月。
租户退出商圈流程要提前通知运营,停止该租户积分发放。
八、两渠道绑定方式对比总览
| 渠道 | 绑定入口 | 获取支付 ID 方式 | 生态限制 |
|---|---|---|---|
| 微信支付 | 已有的微信小程序 | 微信商圈”会员快速积分”插件授权回调,拿支付域 openid | 无,原生支持;注意 openid 三套体系隔离 |
| 支付宝 | 支付宝 App 内打开 H5 网页 | 支付宝开放平台网页应用(H5 OAuth)静默授权,拿 buyer_id | 无法在微信小程序内完成;需新建支付宝网页应用,不能让用户手填 buyer_id |
**一句话汇报口径:**微信支付账号直接在微信小程序接入商圈积分插件完成事前绑定;支付宝账号受生态隔离限制,无法在微信小程序内绑定,需要做一个支付宝开放平台网页应用,依托支付宝商圈的支付通知,在支付宝 App 内打开 H5 授权页面,校验付款账号身份、手机号登录同一套 CRM 后完成 buyer_id 绑定;绑定完成后,微信、支付宝的商圈交易通知共用一张绑定表,统一匹配会员发放积分,全程不开放单号认领,规避冒领。