当前位置：首页 > news >正文

微信支付无缝对接：wechat-php-sdk实现网页支付与扫码支付教程

news 2026/8/9 17:19:31

微信支付无缝对接：wechat-php-sdk实现网页支付与扫码支付教程

【免费下载链接】wechat-php-sdkPHP微信SDK（微信平台 + 微信支付）项目地址: https://gitcode.com/gh_mirrors/wecha/wechat-php-sdk

wechat-php-sdk是一款功能强大的PHP微信SDK，支持微信平台与微信支付功能，能够帮助开发者快速实现网页支付与扫码支付等多种支付方式。本文将为你详细介绍如何使用wechat-php-sdk轻松集成微信支付功能，让你的网站或应用快速拥有专业的支付解决方案。

准备工作：快速安装与配置

环境要求

使用wechat-php-sdk前，确保你的环境满足以下要求：

PHP版本最低为5.4，推荐使用PHP7以获取最佳性能
服务器目录需要有写权限，因为微信部分接口需要缓存数据在本地

安装方式

你可以通过以下几种方式安装wechat-php-sdk：

使用Composer安装（推荐）

Composer是PHP的依赖管理工具，使用它可以方便地管理第三方库，也便于后期更新。在命令行中执行以下命令：

composer require zoujingli/wechat-php-sdk

直接下载源码安装

你也可以直接从代码仓库下载SDK源代码：

通过Git clone命令：git clone https://link.gitcode.com/i/1b07764ca0e482e43ab2c2dd8c5e3cb4
或者直接访问代码仓库下载压缩包：wechat-php-sdk代码仓库

配置参数

安装完成后，需要进行必要的配置。主要配置参数包括公众号appid、商户身份ID（mch_id）、商户支付密钥Key（partnerKey）以及证书路径等。这些信息可以在微信商户平台获取。配置文件可以参考Wechat/WechatPay.php中的相关参数设置。

网页支付实现步骤

网页支付（JSAPI支付）是指在微信内打开的网页中发起的支付，用户可以直接使用微信零钱或绑定的银行卡进行支付。下面是使用wechat-php-sdk实现网页支付的详细步骤：

步骤一：获取用户OpenID

网页支付需要用户的OpenID，因此需要先通过网页授权获取用户的OpenID。你可以使用SDK中的WechatOauth类来实现网页授权功能，具体代码可以参考Wechat/WechatOauth.php。

步骤二：调用统一下单接口获取预支付ID

获取到用户OpenID后，需要调用微信支付的统一下单接口来获取预支付ID（prepay_id）。在wechat-php-sdk中，可以使用WechatPay类的getPrepayId方法来实现。该方法位于Wechat/WechatPay.php文件中，主要参数包括：

openid：用户的OpenID
body：商品标题
out_trade_no：商户订单号
total_fee：订单总价（单位为分）
notify_url：支付成功回调地址
trade_type：支付类型，网页支付为"JSAPI"

示例代码如下：

$wechatPay = new Wechat\WechatPay($config); $prepayId = $wechatPay->getPrepayId($openid, $body, $outTradeNo, $totalFee, $notifyUrl, 'JSAPI');

步骤三：生成JSAPI支付参数

获取到预支付ID后，需要生成JSAPI支付所需的参数，包括appId、timeStamp、nonceStr、package、signType和paySign等。可以使用WechatPay类的createMchPay方法来生成这些参数，该方法同样位于Wechat/WechatPay.php文件中。

示例代码如下：

$payParams = $wechatPay->createMchPay($prepayId);

步骤四：调用微信支付JSAPI

将生成的支付参数传递到前端页面，然后调用微信支付的JSAPI，即可唤起微信支付界面。前端调用代码示例：

wx.chooseWXPay({ appId: payParams.appId, timestamp: payParams.timeStamp, nonceStr: payParams.nonceStr, package: payParams.package, signType: payParams.signType, paySign: payParams.paySign, success: function (res) { // 支付成功后的处理 } });

扫码支付实现步骤

扫码支付是指生成支付二维码，用户使用微信扫描二维码后完成支付。wechat-php-sdk同样提供了便捷的扫码支付实现方式，具体步骤如下：

步骤一：调用统一下单接口获取二维码链接

与网页支付类似，扫码支付也需要先调用统一下单接口。不过，扫码支付的trade_type参数为"NATIVE"。调用WechatPay类的getPrepayId方法，传入相应参数后，会返回二维码链接（code_url）。

示例代码如下：

$wechatPay = new Wechat\WechatPay($config); $codeUrl = $wechatPay->getPrepayId('', $body, $outTradeNo, $totalFee, $notifyUrl, 'NATIVE');

步骤二：生成支付二维码

获取到二维码链接后，需要将其生成二维码图片。你可以使用第三方的二维码生成库，将code_url转换为二维码图片，用户扫描该二维码即可进行支付。

步骤三：查询订单支付状态

生成二维码后，用户可能不会立即支付，因此需要定期查询订单的支付状态。可以使用WechatPay类的queryOrder方法来查询订单状态，该方法位于Wechat/WechatPay.php文件中。

示例代码如下：

$orderInfo = $wechatPay->queryOrder($outTradeNo); if ($orderInfo['trade_state'] == 'SUCCESS') { // 订单支付成功 }

支付结果通知处理

用户支付完成后，微信会将支付结果通过你在统一下单接口中设置的notify_url回调地址通知你的服务器。你需要在该回调地址中处理支付结果，包括验证签名、更新订单状态等。

wechat-php-sdk提供了getNotify方法来处理支付通知，该方法位于Wechat/WechatPay.php文件中。使用示例如下：

$wechatPay = new Wechat\WechatPay($config); $notifyInfo = $wechatPay->getNotify(); if ($notifyInfo) { // 验证签名成功，处理订单 // ... // 回复微信服务器，表示已收到通知 $wechatPay->replyXml(['return_code' => 'SUCCESS', 'return_msg' => 'OK']); }