需先安装yansongdapay扩展包，再配置微信支付参数，接着封装支付服务类，然后处理异步通知，最后前端调用jsapi完成支付。
一、安装YansongdaPay扩展包
YansongdaPay 是一个轻量级、高兼容性的 PHP 支付 SDK，支持微信支付、支付宝等多种渠道。在 ThinkPHP 项目中集成前，需通过 Composer 引入该扩展包，确保其类库可被自动加载。
1、进入 ThinkPHP 项目的根目录（即包含 composer.json 的目录）。
2、执行命令：composer require yansongda/pay:~4.0（推荐使用 v4.x 版本，兼容 PHP 7.4+ 及 ThinkPHP 6/7）。
3、若项目已禁用自动加载或存在命名空间冲突，需运行 composer dump-autoload 刷新自动加载映射。
二、配置微信支付参数
ThinkPHP 需将微信支付所需的凭证信息集中管理，避免硬编码。建议在 config 目录下新建 pay.php 配置文件，统一定义公众号/小程序/APP 等场景的参数结构。
1、在 config/pay.php 中返回如下数组：
return [ 'wechat' => [ 'app_id' => 'wx1234567890abcdef', 'mch_id' => '1234567890', 'mch_secret_key' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'notify_url' => 'https://yourdomain.com/api/pay/wechat/notify', 'cert_client' => __DIR__ . '/../cert/apiclient_cert.pem', 'cert_key' => __DIR__ . '/../cert/apiclient_key.pem' ] ];
2、确保 cert_client 和 cert_key 指向微信商户平台下载的真实证书文件路径，且 Web 服务器有读取权限。
3、notify_url 必须为公网可访问地址，并已在微信商户平台「API安全」中配置为合法回调域名。
三、创建支付服务类封装调用逻辑
为保持业务解耦，应将 Pay::wechat() 实例化与订单生成逻辑封装至独立服务类，避免在控制器中直接操作 SDK。
1、在 app/service 目录下新建 WechatPayService.php。
2、在类中注入配置并初始化客户端：use Yansongda\Pay\Pay; $wechat = Pay::wechat(config('pay.wechat'));
3、定义统一方法 generateOrder($orderData)，其中 $orderData 至少包含 out_trade_no、total_fee（单位：分）、description、openid（JSAPI 场景必需）等字段。
4、调用 $wechat->mp()（公众号）、$wechat->miniapp()（小程序）或 $wechat->app()（APP）生成预支付交易会话参数，并返回给前端。
四、处理微信异步通知
微信支付成功后，会向 notify_url 发起 POST 请求推送结果。该接口必须能接收原始 XML 数据、验签、更新订单状态，并返回特定格式的响应以告知微信已收到。
1、在控制器中定义 public function notify() 方法，禁用中间件（如 verifyToken、auth），并设置响应头 Content-Type 为 text/xml。
2、获取原始输入流：$xml = file_get_contents('php://input');
3、使用 $wechat->verify($xml) 验证签名有效性；失败则返回
4、解析成功后提取 out_trade_no，查询本地订单是否已处理；未处理则更新支付状态、记录 transaction_id，并调用业务完成钩子。
5、无论成功与否，均须返回
五、前端 JSAPI 支付调用
公众号内调用支付需由后端统一下单后返回 JSAPI 参数，前端通过 WeixinJSBridge 或 wx.config + wx.chooseWXPay 完成唤起。
1、后端接口返回字段需包含 appId、timeStamp、nonceStr、package、signType、paySign，全部由 $wechat->mp()->pay() 方法生成。
2、前端确保引入微信 JS-SDK：https://res2.wx.qq.com/open/js/jweixin-1.6.0.js。
3、在调用 wx.chooseWXPay 前，必须先执行 wx.config 并传入 signature、jsApiList:['chooseWXPay'] 等必要参数。
4、wx.chooseWXPay 成功回调中触发订单完成提示；失败回调中捕获 err_msg 判断 'get_brand_wcpay_request:fail cancel' 等常见值并提示用户。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
