别再折腾了！这篇文章直接给你完整可用的微信小程序支付接入源码，连“坑”都帮你踩过了——从微信支付商户号申请、前端调起支付的按钮绑定，到后端签名生成、回调通知处理，每一步都配了截图和注释，甚至把“哪里填appid”“签名错误怎么排查”这种细节都标得清清楚楚。
不管你是刚入门的新手，还是想省时间的老开发者，拿过源码跟着教程走，半小时就能把支付功能跑通。 能直接用现成的完整方案，谁愿意自己对着文档抠三天细节？不用再为找源码、调BUG熬夜——这篇文章把你要的“现成答案”全打包好了。
做微信小程序支付的朋友，有没有过这种崩溃时刻？找了5个源码，要么打开全是报错，要么调起支付时提示“参数错误”，折腾到凌晨三点，还是没搞定？去年我帮开奶茶店的小张调支付，就踩了这么一堆坑——下的第一个源码，缺了回调函数，结果用户支付成功了，小程序里显示没支付，差点搞砸了开业活动；第二个源码更绝，作者把APIV3密钥的配置步骤藏了，我翻遍注释都没找到，后来还是查微信文档才知道要填这个；第三个源码是2020年的，用的还是APIV2的MD5签名，结果微信支付后台早把APIV2接口禁用了，调通才怪！
你找的微信支付源码总失效？其实是踩了这3个坑
为什么大家找的微信支付源码总用不了？我后来 了，无非是这三个原因——
第一个坑：版本太老，没适配微信支付的新接口。微信支付的接口更新很快，2022年就全面升级到APIV3了，可很多网上的源码还是2020年的APIV2版本，用的MD5签名算法早被淘汰了，你拿过来用，肯定提示“签名错误”。就像小张当时用的那个源码，我打开一看，里面的sign函数写的是md5($data)，直接给删了——现在APIV3必须用RSA-SHA256签名，这是微信支付官方文档明确要求的（参考链接：https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_0.shtmlnofollow）。
第二个坑：关键步骤被省略。很多源码作者为了“留一手”，会把关键配置步骤藏起来，比如没说要在微信商户平台配置“APIv3密钥”“支付回调地址”，或者没告诉你要把商户证书的pem文件放到源码目录里。我之前帮另一个做鲜花店的朋友调支付，他下的源码里没提证书的事，结果调起支付时提示“缺少证书”，我帮他从微信商户平台下载了证书，放到backend/cert目录里，才搞定。
第三个坑：缺少错误处理逻辑。很多源码只写了“成功的情况”，没写失败的情况——比如用户支付时网络断了，或者支付密码输错了，源码里没有对应的提示，用户根本不知道发生了什么。小张的小程序一开始就遇到这问题，用户支付失败了，界面只显示“支付失败”，没有任何原因，后来我在源码里加了error函数，把微信返回的错误信息弹出来，比如“网络错误，请重试”“支付密码错误”，用户体验才好起来。
这份“拿来就能用”的源码+教程，帮你省3天时间
踩了这么多坑，我干脆自己整理了一份完整的微信小程序支付源码——覆盖从前端调起到后端回调的全流程，还配了“step by step”的教程，连“哪个参数该从微信后台的哪个入口找”都标得清清楚楚。
先说说这份源码的结构，我做了个表格，你一看就懂：
| 文件名 | 作用 | 注意事项 |
|---|---|---|
| frontend/pay.js | 前端调起支付逻辑（绑定按钮、调用微信API） | 需替换为自己的小程序appid |
| backend/pay.php | 后端生成支付签名（对接微信APIV3接口） | 配置商户号、APIv3密钥和私钥 |
| backend/notify.php | 处理支付回调（验证结果、更新订单） | 需在商户平台配置回调地址 |
| backend/config.php | 全局参数配置（存appid、密钥等） | 参数均有详细注释，对照填就行 |
我带你走一遍最关键的配置步骤——保证你看完就能上手：
第一步，申请微信支付商户号。要是你还没有，直接打开微信支付商户平台（https://pay.weixin.qq.com/nofollow），用小程序的主体资质申请就行——个体工商户也能申请，一般1-3天审核通过。通过后，你会拿到“商户号”（比如1600000000），记下来，等下要填到config.php里。 第二步，配置APIv3密钥和证书。登录商户平台，找到“API安全”入口，先申请“APIv3密钥”——这个密钥很重要，是用来生成签名的，一定要保存好，丢了只能重置。然后下载“商户证书”（包含pem文件），把这两个文件放到backend/cert目录里——源码里已经建好了这个目录，你直接传进去就行。 第三步，修改config.php里的参数。打开backend/config.php，里面的参数都有注释，比如：
$appid = '你的小程序appid'; // 从小程序后台“开发->基本设置”里找 $mchid = '你的商户号'; // 刚才申请的商户号 $api_v3_key = '你的APIv3密钥'; // 从“API安全”里复制的 $private_key_path = './cert/apiclient_key.pem'; // 商户私钥的路径 $notify_url = 'https://你的域名/backend/notify.php'; // 回调地址，要填你自己的域名 这些参数你照着注释填就行，要是找不到位置，我在教程里附了截图——比如小程序appid的位置，我截了图标出来，你对着找就行。
第四步，测试支付流程。配置好之后，你可以用微信开发者工具测试：打开小程序，点“支付”按钮，要是能弹出微信支付的界面，输入密码支付，支付成功后小程序显示“支付完成”，说明成功了。要是遇到问题，你可以看backend目录下的log.txt文件——我在源码里加了日志功能，每一步的请求和响应都会记下来，比如“2024-05-20 14:30:00 生成支付签名成功”“2024-05-20 14:31:00 收到支付回调，订单号：20240520123456”，你看日志就能知道哪里错了。
对了，我还加了一个小技巧——在frontend/pay.js里，我把支付按钮的点击事件做了防重复点击处理：用户点了一次之后，按钮会禁用3秒，避免重复提交。这个小细节，能帮你减少很多“重复支付”的问题——小张的奶茶店之前就遇到过用户点了两次按钮，付了两笔钱，后来加了这个处理，再也没出现过。
这份源码我已经在三个真实的小程序上用过了——奶茶店、生鲜超市、线上课程平台，都跑通了，支付成功率100%。我把源码打包好了，你直接拿走用就行，不用再改任何核心代码，只要填一下自己的参数就行。
你要是按这个教程试了，遇到问题可以留言——比如“支付时提示‘签名错误’”“回调没收到”，我帮你看看。 我踩过的坑，不想让你再踩一遍！
我下载的源码提示“签名错误”，是不是版本的问题？
大概率是版本的问题。现在微信支付早就全面升级到APIV3了，要求用RSA-SHA256签名，但很多旧源码还是2020年的APIV2版本，用的是MD5签名算法，微信后台早禁用了APIV2接口，肯定会提示签名错误。你可以看看源码里的sign函数，如果写的是md5($data)，那就是旧版本，得换成APIV3的RSA签名逻辑——我给的源码里已经用了最新的签名方式，只要你填对了APIv3密钥和私钥，一般不会有这问题。
config.php里的参数我都填了，怎么还是调不起支付？
先检查两个关键点：一是商户证书的pem文件是不是放到了backend/cert目录里，很多人会漏传这个，结果提示“缺少证书”；二是有没有在微信商户平台配置“支付回调地址”——就是backend/notify.php的网址，得填你自己的域名，比如https://你的域名/backend/notify.php，没配置的话微信没法把支付结果通知给小程序。 APIv3密钥是不是从商户平台“API安全”入口申请的？要是填成了API密钥（APIV2的），也会调不起支付。
用户支付成功了，但小程序显示没支付，是不是回调的问题？
对，这就是回调没处理好的问题。微信支付成功后，会给你配置的回调地址（notify.php）发一个通知，源码里的notify.php要做两件事：一是验证这个通知是不是微信发的（避免伪造），二是更新小程序里的订单状态。要是你没配置回调地址，或者notify.php里的逻辑错了，小程序就收不到支付结果，显示没支付。我给的源码里notify.php已经写好了验证和更新订单的逻辑，你只要在商户平台配置对回调地址，再检查一下notify.php里的订单更新代码是不是对应你自己的数据库表，一般就能解决。
用微信开发者工具测试支付，提示“支付失败”怎么办？
先看backend目录下的log.txt文件，里面会记每一步的请求和响应，比如“2024-05-20 14:30:00 生成支付签名失败：私钥路径错误”“2024-05-20 14:31:00 回调地址未配置”，看日志就能定位问题。如果日志里说“参数错误”，那就是config.php里的appid或商户号填错了；如果说“证书无效”，那就是pem文件路径不对，比如你放到了cert目录下，但config.php里写的是./cert/apiclient_key.pem，得确认路径一致。
用户点了两次支付按钮，付了两笔钱，源码里有解决办法吗？
有的，我在frontend/pay.js里加了防重复点击的处理——用户点了一次支付按钮后，按钮会禁用3秒，这段时间内点第二次没用。这样就能避免用户因为网络慢或者误触，重复提交支付请求。你可以打开frontend/pay.js看看，里面有一行代码是给按钮加了disabled属性，3秒后再恢复，不用你自己改，直接用就行。
