接入易错点

更新时间:2026.10.30
||| 安装 Skill

一、合单支付结果、查单与子单状态

注意事项

说明、正确应该怎么做

不做会怎么样

 合单子单不得按部分成功或部分失败处理

 说明:合单多笔子单不会出现其中一笔支付失败、其他子单支付成功的情况,支付结果按合单订单整体确认。
正确应该怎么做:① 调用小程序合单下单接口取得 prepay_id;② 用户从收银台返回后,服务端调用查询合单订单接口确认合单订单及子单状态;③ 业务系统按合单结果统一更新关联订单,不设置“部分子单成功”分支。
典型反例:把每个子单当作可独立完成支付的订单,分别确认成功并分别发货或记账。
见 4012079115-小程序合单支付开发指引、4013421468-小程序合单支付常见问题、4012166836-服务商小程序合单支付开发指引、4013462619-服务商小程序合单支付常见问题 

 若按部分成功设计业务处理,可能出现支付状态与发货、记账状态不一致,造成漏发或错误履约。

二、小程序调起支付签名与 paySign 组包

注意事项

说明、正确应该怎么做

不做会怎么样

 调起支付签名须使用本次下单的 combine_appid

 说明:小程序调起支付的 paySign 必须使用合单下单时传入的 combine_appid 计算;下单、签名和实际调起支付使用的 AppID 须保持一致。
正确应该怎么做:① 服务端从本次下单结果中取 combine_appid;② 使用该 AppID、timeStamp、nonceStr 和 prepay_id= 开头的 package 值构造签名串;③ 返回同一小程序调用 wx.requestPayment;④ 多小程序场景按当前交易所属小程序分别取 AppID。
典型反例:多个小程序共用后台时,统一使用其中一个固定 AppID 生成调起支付签名。
见 4012266109-小程序合单支付API列表小程序调起支付、4012365341-小程序调起支付签名、4012079115-小程序合单支付开发指引、4012166847-服务商小程序调起支付 

 调起支付失败,用户无法进入微信支付收银台完成付款。

 调起支付签名串须保留 prepay_id= 前缀

 说明:小程序调起支付签名串共四行,末行必须为 prepay_id=<下单返回的prepay_id>;wx.requestPayment 的 package 也使用同一格式。
正确应该怎么做:① 按“AppID、时间戳、随机字符串、prepay_id=<prepay_id>”顺序逐行拼接;② 每行末尾包含 \n,最后一行也包含;③ 使用商户 API 证书私钥生成 SHA256 with RSA 签名并 Base64 编码;④ 将同一 prepay_id= 值放入 package。
典型反例:签名串末行只放 prepay_id 的值,遗漏 prepay_id= 前缀。
见 4012365341-小程序调起支付签名、4012266109-小程序合单支付API列表小程序调起支付、4012556931-小程序合单下单 

 paySign 校验不通过,用户无法拉起微信支付收银台。