php如何对接微信支付V3版本（保姆级别）

本文主要记录php对接微信支付v3版本的整个过程，包含支付、退款、回调等功能，会从申请证书开始记录

一、证书申请 V3

1、入口介绍

在微信商户平台中，[账户中心]->[API安全]中可以看到这样的界面

证书的申请在商户API证书下面的管理证书

2、证书工具下载

目前支持windows和mac版本，下载安装到本机

3、修改证书保存地址

运行证书工具后，修改证书保存路径

4、生成证书请求串

5、生成证书

将证书请求串复制到商户平台证书管理界面粘贴进去，然后在工具上点击生成证书，会在你证书保存路径的地方生成两个文件：apiclient_cert.pem和apiclinet_key.pem

二、cert.pem证书生成

注意：V3版本中cert.pem证书不同于apiclient_cert.pem证书，它是由命令工具生成，确切的说apiclient_cert.pem是没有用的，而cert.pem才是真正在代码对接中有用的，这里相对于v2版本有很大的区别，这里也是最容易混淆的地方。

1、下载php依赖

1	composer require wechatpay/wechatpay

github地址：https://github.com/wechatpay-apiv3/wechatpay-php

2、运行命令生成证书

找到该路径： /vendor/wechatpay/wechatpay/bin 下，有个 CertificateDownloader.php 文件，可通过php去执行它能看到命令行的提示：

-m 商户号：这个不用说
-s 商户证书序列号：在商户平台生成证书后所对应的证书序列号
-f 商户的秘钥文件：通过证书工具生成的apiclient_key.pem这个文件
-k APIv3: 在商户平台API安全中可以找到，本文中图一可以看到

全部设置好后执行命令（参考）:

1	php CertificateDownloader.php -m 1635059363 -k NrAsJhcefMRkHKkMtNGrAtTdKtKaTTmY -f ../../../../config/merchant/apiclient_key.pem -s 7A56DCFEEE02E7F56C18E04EFF7D488A44D6AABB

成功后会得到以下结果：

此时就得到了cert.pem的内容，自行保存证书。

三、业务对接

以下WechatPayServiceV3.php为实例，以app支付为场景，提供如下service，里面有微信支付、退款、回调等业务逻辑，特别注意微信配置的地方，也可以参照github上提供的参考代码。

<?php

namespace app\api\service;

use think\facade\Log;
use WeChatPay\Builder;
use WeChatPay\Crypto\Rsa;
use WeChatPay\Formatter;
use WeChatPay\Util\PemUtil;

/**
 * 微信支付 V3
 * Class WechatPayServiceV3
 */
class WechatPayServiceV3
{
    /** @var Builder::factory $resp */
    protected $instance;

    public function __construct()
    {
        $this->_init();
    }

    /**
     * - apiV3实例初始化
     * @return void
     */
    public function _init()
    {
        // 商户号，假定为`1000100`
        $merchantId = config('wechat.merchantId', '');
        // 从本地文件中加载「商户API私钥」，「商户API私钥」会用来生成请求的签名
        $merchantPrivateKeyFilePath = "file://".config_path().'merchant/apiclient_key.pem';
        $merchantPrivateKeyInstance = Rsa::from($merchantPrivateKeyFilePath, Rsa::KEY_TYPE_PRIVATE);

        // 「商户API证书」的「证书序列号」 ，从微信支付提供的「平台证书」中获取
        $merchantCertificateSerial = config('wechat.mchSerialNo', '');

        // 从本地文件中加载「微信支付平台证书」，用来验证微信支付应答的签名
        // 【**】【打死要特别注意】：这里是坑，以下的cert.pem并不是工具生成的apiclient_cert.pem这个证书，而是通过/vendor/wechatpay/wechatpay/bin 下的工具生成的！
        $platformCertificateFilePath = "file://".config_path().'merchant/cert.pem';
        $platformPublicKeyInstance = Rsa::from($platformCertificateFilePath, Rsa::KEY_TYPE_PUBLIC);

        // 从「微信支付平台证书」中获取「证书序列号」
        $platformCertificateSerial = PemUtil::parseCertificateSerialNo($platformCertificateFilePath);

        // 构造一个 APIv3 客户端实例
        $this->instance = Builder::factory([
            'mchid'      => $merchantId,
            'serial'     => $merchantCertificateSerial,
            'privateKey' => $merchantPrivateKeyInstance,
            'certs'      => [
                $platformCertificateSerial => $platformPublicKeyInstance,
            ],
        ]);
    }

    /**
     * - 生成支付签名
     * @param $prepayId
     * @return array
     */
    public function getPaySign($prepayId): array
    {
        $merchantPrivateKeyFilePath = "file://".config_path().'merchant/apiclient_key.pem';
        $merchantPrivateKeyInstance = Rsa::from($merchantPrivateKeyFilePath);
        $params = [
            'appId'     => config('wechat.appid', ''),
            'timeStamp' => (string)Formatter::timestamp(),
            'nonceStr'  => Formatter::nonce(),
            'prepay_id' => $prepayId,
        ];
        $params += ['paySign' => Rsa::sign(
            Formatter::joinedByLineFeed(...array_values($params)),
            $merchantPrivateKeyInstance
        ), 'signType' => 'RSA'];
        return $params;
    }

    /**
     * - 微信支付 V3
     * #依赖包文档： https://packagist.org/packages/wechatpay/wechatpay
     * #微信app支付文档：https://pay.weixin.qq.com/docs/merchant/apis/in-app-payment/direct-jsons/app-prepay.html
     * @param $options
     * @param $notifyURL // 回调地址
     * @return array
     * @throws \Exception
     */
    public function pay($options, $notifyURL): array
    {
        try {
            $appid = config('wechat.appid', '');
            $mchid = config('wechat.merchantId', '');
            // 同步支付
            try {
                // 参数整理 请参照：https://pay.weixin.qq.com/docs/merchant/apis/in-app-payment/direct-jsons/app-prepay.html
                $params = [
                    'json' => [
                        'appid'        => $appid, // 微信appid
                        'mchid'        => $mchid, // 商户号
                        'description'  => $options['subject'],     //商品描述
                        'out_trade_no' => $options['outTradeNo'],  // 商户系统内部订单号
                        'notify_url'   => $notifyURL,              // 回调地址
                        'amount'       => [
                            'total'    => intval($options['totalAmount'] * 100),   // 订单总金额，单位为分。
                            'currency' => 'CNY',
                        ],
                    ],
                ];
                $resp = $this->instance->chain('v3/pay/transactions/app')->post($params);
                $resp = $resp->getBody()->getContents();
            } catch (\GuzzleHttp\Exception\RequestException $e) {
                $r = $e->getResponse();
                $resp = $r->getBody()->getContents();
                Log::channel('wechat_notify')->error("微信支付创建订单 请求异常", ['StatusCode' => $r->getStatusCode() . ' ' . $r->getReasonPhrase(), 'Body' => $r->getBody(), 'outTradeNo' => $options['outTradeNo']]);
            } catch (\Exception $e) {
                Log::channel('wechat_notify')->error("微信支付创建订单 异常", ['description' => $options['subject'], 'outTradeNo' => $options['outTradeNo'], 'money' => $options['totalAmount'], 'TraceAsString' => $e->getTraceAsString(), 'msg' => $e->getMessage()]);
                throw $e;
            }
            // 处理结果
            $res = json_decode($resp, true);
            $paySign = $this->getPaySign($res['prepay_id']);
            return [
                'appid'     => $appid,
                'partnerid' => $mchid,
                'prepayid'  => $res['prepay_id'],
                'package'   => "Sign=WXPay",
                'noncestr'  => $paySign['nonceStr'],
                'timestamp' => $paySign['timeStamp'],
                'sign'      => $paySign['paySign'],
            ];

        } catch (\Exception $e) {
            // 进行错误处理
            if ($e instanceof \GuzzleHttp\Exception\RequestException && $e->hasResponse()) {
                $r = $e->getResponse();
            }
            //echo $e->getTraceAsString(), PHP_EOL;
            Log::channel('wechat_notify')->error("微信支付创建订单 异常". $e->getMessage()."|".$e->getLine());
            throw new \Exception($e->getMessage());
        }
    }

    /**
     * - 微信退单 V3
     * @param $info
     * @return bool
     */
    public function orderRefund($info): bool
    {
        $promise = $this->instance
            ->chain('v3/refund/domestic/refunds')
            // 参数整理 请参考：https://pay.weixin.qq.com/docs/merchant/apis/in-app-payment/create.html
            ->postAsync([
                'json' => [
                    'transaction_id' => (string)$info['trade_no'],  // 交易号
                    'out_refund_no'  => (string)$info['order_sn'],  // 系统内部订单号
                    'amount'         => [
                        'refund'   => $info['actual_price'] * 100,  // 退款金额，单位为分，只能为整数，不能超过原订单支付金额。
                        'total'    => $info['actual_price'] * 100,  // 原支付交易的订单总金额，单位为分，只能为整数
                        'currency' => 'CNY',
                    ],
                ],
            ])
            ->then(static function($response) {
                // 正常逻辑回调处理
                echo $response->getBody(), PHP_EOL;
                return $response;
            })
            ->otherwise(static function($e) {
                // 异常错误处理
                echo $e->getMessage(), PHP_EOL;
                if ($e instanceof \GuzzleHttp\Exception\RequestException && $e->hasResponse()) {
                    $r = $e->getResponse();
                    echo $r->getStatusCode() . ' ' . $r->getReasonPhrase(), PHP_EOL;
                    echo $r->getBody(), PHP_EOL, PHP_EOL, PHP_EOL;
                }
                echo $e->getTraceAsString(), PHP_EOL;
            });
        // 同步等待
        $promise->wait();
        Log::error("微信退款结果：".json_encode($promise));
        $promise = json_decode($promise, true);
        if(isset($promise['status']) && $promise['status'] == 'SUCCESS'){
            return true;
        }
        return false;
    }
}