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

Laravel7 + easyWeChat 实现微信公众号支付功能

news 2025/8/4 9:20:21

注册服务号，需进行微信认证，此时需缴费 300 元/年，必须是认证成功的服务号才能开通微信支付。

注册微信支付商户号

1、登录 https://pay.weixin.qq.com/index.php/core/home/login?return_url=https%3A%2F%2Fpay.weixin.qq.com%2Findex.php%2Fextend%2Fpay_setting%2Fma，

点击 接入微信，点击 注册微信支付商户号 ，按步骤 创建申请单–填写商户资料–确认提交 即可。 <按提示进行操作即可，步骤无比繁琐>

2、管理员微信号关注 微信支付商家助手 ，以上操作步骤完成并通过后，商家助手会收到 入驻申请进展通知---待签约 ，用管理员手机点进去，扫脸确认签约即可，完成后商家助手会收到 入驻成功 信息。

3、接下来完成 APPID授权管理，登录到微信服务号首页，找到 设置与开发---接口权限，在右边找到 微信支付接口---未获得，点击 申请。在 待关联商户号 一栏中，点击 确认 ，同意授权即可。
此时在 已关联商户号 一栏中显示对应内容，返回 接口权限 页面，查看右边的 微信支付接口 显示 已获得。

微信支付商户后台配置

1、微信商户平台(pay.weixin.qq.com)–>账户中心–>账户设置–>API安全–>设置API密钥，密钥需下载下来放到项目的根目录。接下来设置 APIv2 秘钥、设置 APIv3 秘钥。
请添加图片描述

2、产品中心–>开发配置–>支付配置，在此添加 JSAPI支付授权目录，如下图所示：
请添加图片描述

3、关联服务号，如下图：
请添加图片描述

4、登录微信公众服务号后台，对公众号进行功能设置，如下图：
请添加图片描述

微信支付功能开发

1、打开 easyWeChat 官网，找到 Laravel 5 拓展包，按步骤安装 laravel-wechat。
请添加图片描述

// 安装easyWeChat包
composer require "overtrue/laravel-wechat:~5.1"// 创建配置文件
php artisan vendor:publish --provider="Overtrue\LaravelWeChat\ServiceProvider"

在 composer.json 中显示的 laravel-wechat 版本号为 "overtrue/laravel-wechat": "^5.1", 。

在项目的 config 文件夹中自动生成 wechat.php 文件。

2、在 config/wechat.php 中打开微信支付的配置，然后在 .env 文件中做如下配置：

WECHAT_DEBUG=true# 此配置是实现微信公众号登录认证的配置
WECHAT_OFFICIAL_ACCOUNT_APPID='微信公众号的APPID'
WECHAT_OFFICIAL_ACCOUNT_SECRET='微信公众号的开发者密码(AppSecret)'
WECHAT_OFFICIAL_ACCOUNT_TOKEN='随意字符串'WECHAT_PAYMENT_APPID='微信公众号APPID'
WECHAT_PAYMENT_MCH_ID='微信支付商户号'
WECHAT_PAYMENT_KEY='Hubei***********8'

3、添加下单和支付路由：

Route::prefix('order')->group(function () {// 下单Route::post('/', 'OrderController@store');// 支付Route::get('/pay/{id}', 'OrderController@pay');
});

4、创建订单的控制器方法和模型以及数据表 orders

php artisan make:controller OrderControllerphp artisan make:model Models/Order// 模型里面添加黑名单
protected $guarded = [];// orders 表的字段，以下只是范例，可根据需求自行添加
id、customer_id、out_trade_no、status、total_price、created_at、pay_time、updated_at

我的表结构如下：
请添加图片描述
5、在 Order 控制器里面的 store 方法,代码如下:

use App\Models\Shop\Address;
use App\Models\Shop\Cart;
use App\Models\Shop\Order;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;// 下单
function store(Request $request)
{$carts = Cart::with('product')->where('customer_id', session('wechat.customer.id'))->get();// 防止用户使用微信的后退按钮，重新提交订单，导致出现没有数据的订单if ($carts->isEmpty()) {return ['status' => 0, 'info' => ''];}$count = Cart::count_cart();$total_price = $count['total_price'];DB::beginTransaction();try {//生成订单$order = Order::create(['out_trade_no'=> Order::make_orderNo(),'customer_id' => session('wechat.customer.id'),'total_price' => $total_price,'status' => 1]);//订单地址$address = Address::find($request->address_id);$order->address()->create(['province' => $address['province'],'city' => $address['city'],'area' => $address['area'],'detail' => $address['detail'],'name' => $address['name'],'tel' => $address['tel'],]);$carts = Cart::with('product')->where('customer_id', session('wechat.customer.id'))->get();foreach ($carts as $cart) {//判断库存是否足够if ($cart->product->stock != '-1' and $cart->product->stock - $cart->num < 0) {throw new \Exception('商品' . $cart->product->name . ", 目前仅剩下" . $cart->product->stock . " 件. \n请返回购物车, 修改订单后再下单!");}//削减库存数量if ($cart->product->stock != '-1') {$cart->product->decrement('stock', $cart->num);}//插入订单商品表$order->order_products()->create(['product_id' => $cart->product_id,'num' => $cart->num]);}//清空购物车Cart::where('customer_id', session('wechat.customer.id'))->delete();} catch (\Exception $e) {//echo $e->getMessage();DB::rollback();return ['status' => 0, 'info' => $e->getMessage()];}DB::commit();return ['status' => 1, 'order_id' => $order->id];
}

6、在 Order 控制器里面的 pay 方法,代码如下:

use App\Models\Shop\Order;
use EasyWeChat;// 微信支付
function pay($id)
{$payment = EasyWeChat::payment();// 第 1 步：查询订单并计算金额$order = Order::with('address')->find($id);// 第 2 步：统一下单$result = $payment->order->unify(['body' => '测试支付','out_trade_no' => $order->out_trade_no,'total_fee' => $order->total_price * 100,'notify_url' => 'https://shop.***.com/order/notify', // 支付结果通知网址'trade_type' => 'JSAPI','openid' => session('wechat.customer.openid'),]);// return $result; // 打印$result看是否有结果// 第 3 步：JSSDKif ($result['result_code'] == 'SUCCESS' && $result['return_code'] == 'SUCCESS') {$prepayId = $result['prepay_id'];$jssdk = $payment->jssdk;$json = $jssdk->sdkConfig($prepayId);// return $json; // 打印$json看是否有结果return view('wechat.order.show_pay', compact('order', 'json'));} else {return $result;}
}

接下来，我们来测试一下上述代码，打印 return $result;。打开 微信开发者工具 ，进入商城首页，依次添加商品到购物车、选择地址、下单，会得到如下图结果：
请添加图片描述
继续测试，打印 return $json;。就在上图结果中刷新地址，你会得到如下结果：

7、在前端页面底部增加 js 调用代码如下：

<script>$(function () {$("#pay").click(function () {if (typeof WeixinJSBridge === 'undefined') {alert('请在微信在打开页面！');return false;}WeixinJSBridge.invoke('getBrandWCPayRequest', {!! json_encode($json) !!}, function (res) {switch (res.err_msg) {case 'get_brand_wcpay_request:cancel':alert('您取消了支付！');break;case 'get_brand_wcpay_request:fail':alert('支付失败！（' + res.err_desc + '）');break;case 'get_brand_wcpay_request:ok':alert('支付成功！');location.href = '/order';break;default:alert(JSON.stringify(res));break;}});})})
</script>

接下来测试是否能唤起微信支付密码窗口，输入密码后显示支付成功。

注：如有出现错误 调用支付 JSAPI 缺少参数 timeStamp，解决办法：在你项目的 vendor/overtrue/wechat/src/Payment/Jssdk/Client.php 中屏蔽两行代码就行。

public function sdkConfig(string $prepayId): array
{$config = $this->bridgeConfig($prepayId, false);// 屏蔽这两行代码//  $config['timestamp'] = $config['timeStamp'];//  unset($config['timeStamp']);return $config;
}

如有其他错误，可以在评论区交流。

微信支付回调

1、首先增加支付回调路由，注意此路由应放在 middleware 中间件路由外面，回调路由请求必须是 post

//支付成功回调
Route::namespace('Wechat')->group(function () {Route::post('/order/notify', 'OrderController@notify');
});

请添加图片描述
2、laravel 框架必须取消回调路由的 csrf 防护。在你项目的 app/Http/Middleware/VerifyCsrfToken.php 中加入如下代码：

protected $except = ['order/notify', // 回调路由取消csrf防护
];

3、回调代码如下：

/*** 微信支付回调方法，修改订单状态* @return mixed*/
function notify()
{$payment = EasyWeChat::payment();$response = $payment->handlePaidNotify(function ($message, $fail) {if ($message['return_code'] === 'SUCCESS' && $message['result_code'] === 'SUCCESS') {// \Log::debug($message);Order::where('out_trade_no', $message['out_trade_no'])->update(['status' => 2, 'pay_time' => Carbon\Carbon::now()]);//更改订单状态//支付后，微信会在此处返回支付状态，就是$message，回调里面打印不出来，可通过写入日志里面查看，支付成功后更改订单状态。当然你也可以进行其他操作。return true;} else {// \Log::debug('我不买了');return $fail('失败');}});return $response;
}