记一次wechatpay-apiv3微信支付SDK的使用

最新推荐文章于 2026-07-21 07:49:08 发布

原创

最新推荐文章于 2026-07-21 07:49:08 发布 · 3.6k 阅读

本文记录了使用wechatpay-apiv3微信支付SDK的过程，包括环境要求、安装和具体使用。重点介绍了商户相关参数设置，如商户号、API证书序列号和私钥，以及平台证书的获取和解密流程。

记一次wechatpay-apiv3微信支付SDK的使用

介绍

微信支付API v3的Guzzle HttpClient中间件Middleware，实现了请求签名的生成和应答签名的验证。

项目地址：https://github.com/wechatpay-apiv3/wechatpay-guzzle-middleware

环境要求

PHP 5.5+ / PHP 7.0+

guzzlehttp/guzzle 6.0+

安装

// 添加wechatpay sdk依赖
composer require wechatpay/wechatpay-guzzle-middleware
// 添加guzzle依赖
composer require guzzlehttp/guzzle:~6.0

SDK使用

require_once __DIR__.'/vendor/autoload.php';

use GuzzleHttp\Exception\RequestException;
use WechatPay\GuzzleMiddleware\WechatPayMiddleware;
use WechatPay\GuzzleMiddleware\Util\PemUtil;

// 商户相关配置
$merchantId = 'XXXX'; // 商户号
$merchantSerialNumber = 'XXXX'; // 商户API证书序列号
$merchantPrivateKey = PemUtil::loadPrivateKey('./cert/apiclient_key.pem'); // 商户aip证书私钥
// 微信支付平台配置
$wechatpayCertificate = PemUtil::loadCertificate('./cert/wechatPay_cert.pem'); // 微信支付平台证书

// 构造一个WechatPayMiddleware
$wechatpayMiddleware = WechatPayMiddleware::builder()
    ->withMerchant($merchantId, $merchantSerialNumber, $merchantPrivateKey) // 传入商户相关配置
    ->withWechatPay([ $wechatpayCertificate ]) // 可传入多个微信支付平台证书，参数类型为array
    ->build();

// 将WechatPayMiddleware添加到Guzzle的HandlerStack中
$stack = GuzzleHttp\HandlerStack::create();
$stack->push($wechatpayMiddleware, 'wechatpay');

// 创建Guzzle HTTP Client时，将HandlerStack传入
$client = new GuzzleHttp\Client(['handler' => $stack]);


// 接下来，正常使用Guzzle发起API请求，WechatPayMiddleware会自动地处理签名和验签
try {
   
   
  	// 接口地址
    $resp = $client->request('POST', 'https://api.mch.weixin.qq.com/v3/...', [