互联网教程

微信支付怎么接进小程序

发布者:黔序科技更新于 2026-11-06 12:48依据官方文档核验:2026 年 11 月

AI 导读

约 2 分钟读完

资金安全底线只认后端验签通过的回调,而非前端返回的 success。针对企业决策者关注的支付对接风险与稳定性问题,本文拆解了从商户号关联、JSAPI 下单到异步通知处理的完整链路,明确了签名参数透传、金额单位换算及幂等性校验的具体执行标准,帮助技术团队规避重复发货、回调丢失等常见故障,确保交易闭环可靠运行。

  • 唯一可信支付信号是后端验签通过的回调
  • 订单金额必须统一为分单位避免计算误差
  • 回调处理需实现幂等更新防止重复发货
  • HTTPS 域名与公网可达性是回调前提
  • 前端兜底查单可缓解回调延迟显示问题

内容由 AI 智能生成,仅供参考

一句话:正确链路:小程序释请求后端释下单 → 后端调微信下单接口释拿 prepay_id → 后端签名返回 → 小程序调起支付 → 微信回调后端 → 后端验签、改单、发货 → 小程序查单确认。

接入步骤

  1. 关联商户号在小程序后台关联已申请的商户号并完成确认。
  2. 后端下单调用 JSAPI 下单接口,传 openid、金额(单位分)、订单号、回调地址。
  3. 返回签名参数把 prepay_id 等参数按规则签名后返回给小程序。
  4. 小程序调起支付调用支付接口,用户完成付款。
  5. 处理后端回调验签 → 校验金额与订单号 → 幂等更新订单 → 返回成功应答。
  6. 前端兜底查单支付返回后主动查一次订单状态,避免回调延迟导致页面显示未支付。

注意:唯一可信的支付成功信号是「后端收到并验签通过的回调」,不是前端返回的 success。前端结果可以被伪造或用户中途退出,只认回调是资金安全底线。

回调必须做的三件事

  • 验签用平台证书验证回调签名,拒绝伪造请求。
  • 幂等同一笔订单多次回调只处理一次,用订单号做唯一键或状态机。
  • 返回应答处理成功要按协议返回成功,否则微信会持续重试。

常见故障

  • 签名错误:密钥用错、参数拼错、时间戳过期。按官方签名工具逐步核对。
  • 回调收不到:地址不是 HTTPS释、公网不可达、被防火墙拦、路径写错。
  • 金额不一致:前端传元、后端传分,或含运费/优惠的金额计算不一致。
  • 重复发货:没做幂等,回调重试导致发两次。

资料来源

  • 微信支付释 APIv3《JSAPI 支付》开发文档:下单、调起、回调流程。
  • 微信支付《签名与验签》说明。
  • 微信支付《回调通知》重试机制与应答要求。

常见问题

回调没收到,但用户说付款成功了怎么办?

用查单接口主动查询订单状态,查到已支付就补单。同时排查回调地址可达性。资金以微信侧订单状态为准。

能用同一个商户号接多个小程序吗?

可以,多个 AppID 可关联同一商户号。但订单要带清 AppID 区分来源,对账时才分得清。

测试环境怎么联调支付?

用沙箱或小额真实支付,正式环境不要用 1 分钱反复测(有风控)。回调地址在测试环境也要能公网访问。

相关阅读