小程序支付对接（微信支付/易支付）：商户号、密钥、回调，3 段配错等于钱不到账

“小程序支付怎么对接？商户号在哪绑？””调起支付一直签名错误怎么办？””顾客付了钱，后台订单还是未支付？”——支付是小程序上线前最让人紧张的一环，因为这里错一处，就是真金白银不到账。有个做知识付费的站长，微信支付对接完自以为好了，上线第一天卖了三十多单，结果后台全显示”未支付”，查了半天才发现是支付回调地址写错、异步通知没收到，钱其实到了商户号，订单却没更新，退款退到手软。他不是个例——支付对接的坑，九成在”商户号绑定、密钥、回调”这三段，任何一处错，前端能调起、用户能付，但你的系统不知道”付成功了”。下面把两条路都讲清。

一、先分清：微信支付 vs 易支付

• 微信支付（官方）：直连微信，资金进你商户号，费率标准、最稳，需企业/个体户资质+商户号；
• 易支付（聚合/中转）：对接一个聚合平台，平台再连微信/支付宝，适合没资质或想接多通道，但资金先过平台，需选靠谱服务商、注意合规。

能走官方微信支付优先官方；实在资质受限再评估易支付，并确认其通道合规，别踩”二清”红线。

二、微信支付对接第 1 段：商户号与小程序绑定

1. 微信支付商户平台注册商户号（需主体与小程序一致）；
2. 在商户平台”产品中心”开通”JSAPI 支付”；
3. 在微信公众平台→微信支付→关联商户号，绑定你的小程序 AppID 与商户号；
4. 记下：商户号 mchid、AppID、APIv3 密钥、API 证书（apiclient_cert.pem / key.pem）。

绑错主体或不一致，调起即报”商户号与 AppID 不匹配”。

三、微信支付对接第 2 段：后端签名与统一下单

后端用 PHP 调统一下单接口（/v3/pay/transactions/jsapi），关键：

• 用 APIv3 密钥对回包解密；
• 签名用商户私钥（证书 key.pem）按微信规则生成；
• 返回前端 paySign 所需的 timeStamp/nonceStr/prepay_id 等。

常见”签名错误”：时间戳用秒还是毫秒不对、签名串拼接顺序错、证书路径错。建议直接用官方 SDK 或成熟封装，别手撸签名。

四、微信支付对接第 3 段：支付回调（最易翻车）

用户付成功后，微信会向你的”回调通知地址”发 POST（异步通知）：

• 后端收到后先验签（用平台证书验签，防伪造）；
• 解密出订单号，把本地订单置”已支付”；
• 必须返回成功响应（如 {code:'SUCCESS'}），否则微信会重试；
• 做好幂等：同一订单通知可能来多次，别重复发货/重复处理。

前面那位站长就是回调地址 404、订单没更新。回调地址必须 HTTPS、公网可达、不被防火墙拦。

五、易支付对接（聚合通道）

易支付通常是更简单的一套：

• 在易支付平台拿 pid（商户ID）、key（密钥）、api网关地址；
• 后端按平台文档用 pid+key+参数 生成签名，请求下单接口；
• 同步跳转 + 异步通知（notify_url）更新订单；
• 同样要验签、幂等、返回 success。

易支付好处是配置简单、常免企业资质，但要注意：资金先到平台再结算，选有牌照/口碑的服务商，确认不是违规二清。

六、常见故障排查表

现象	原因	处理
调起报商户号不匹配	主体/AppID 未绑定	公众平台关联商户号
签名错误	证书/时间戳/拼接错	用官方 SDK、核对
付了订单未更新	回调地址错/未返成功	查 notify_url 可达+返回
回调收不到	地址非 HTTPS/被拦	放通 443、填公网地址
易支付不通知	key 错/notify 写错	核对签名与地址

七、支付对接前 6 项自查

• [ ] 商户号主体与小程序一致并已绑定
• [ ] JSAPI 支付已开通
• [ ] APIv3 密钥/证书路径正确
• [ ] 回调地址 HTTPS 公网可达
• [ ] 后端验签+幂等+返回成功
• [ ] 用 0.01 元实测全链路

八、受益人视角

支付通了，受益人是一线最怕对账的人：财务不用再手工核每笔钱、运营敢投广告因为成交闭环了、顾客付完立刻看到”购买成功”。把”对接支付”翻译成他们的好处：财务不熬夜对账、运营投放有底气、顾客不卡在付款。你多花心思把回调配对，省下的是每天对账的崩溃和退款的口碑损失。

九、消费借口：把支付配稳不是”技术细节”，是”营收的最后一米”

有人觉得”能付就行，回调晚点配”。换损失框架：支付是营收的最后一米——前端再漂亮、推广再猛，支付回调一错，钱到了订单没更新，要么漏单要么乱退款，一天几十单就够你喝一壶。你认真对待这段配置，买的不是”技术正确”，是”每一笔收入都落袋为安”的确定性。这最后一米，最贵，也最不能省。

八、补充：上线后盯紧”支付成功率”这个生死指标

支付对接完别以为万事大吉。上线头一周，每天看一眼支付成功率：正常应在 98% 以上，若掉到 90% 以下，多半是某个机型或某个网络下调起异常、或回调偶发失败。把”支付失败订单”当告警处理，别等顾客投诉才发现钱收不上来。

另外，定期对账：商户号流水、小程序订单、后台财务三方对平，差额就是”付了没更新”或”更新了没到账”的隐患。对账这习惯，能帮你在大面积出错前就掐掉火苗。一句话，支付是营收的最后一米，监控和核对不是”运维琐事”，是每天都必须守的门——守住它，每一笔收入才真正落袋为安。

---

📦 卓创源码网：小程序源码支付模块支持微信支付/易支付，回调与验签齐全，拒绝”付了不更新”的半成品。浏览对应栏目：{{下载页链接}} 🔗 后端接口怎么写？看：{{部署教程链接}}