– 君看蕙风来处

#### 一、前提描述

------------

微信商户号于 2022.5.18号开始，关闭了`企业付款到零钱`（v2接口），改为了`商家转账到零钱`（v3接口）。之前开通的企业付款到零钱还能继续使用，5.18之后只能开通 `商家转账到零钱`。

##### ps：这里不得不说一句，新产品真不好用，特别是以下几点：
- （1）调用API不会返回转账成功失败，需要单独调用查询转账明细接口。
- （2）商家转账API 有额度默认，最大200，需要更高额度得填写资料申请。
- （3）修改产品设置时，一步一个验证码，障碍做的非常到位。

------------

因为fastadmin框架用的是yansongdaV2版，所以不支持最新的 “商家转账到零钱”，而且框架目前还不支持升级到yansongdaV3，于是找到了微信官方的 composer 包： [wechatpay-php](https://github.com/wechatpay-apiv3/wechatpay-php "wechatpay-php")

##### 另外需要提前准备些资料：
- （1） 微信商户号ID
- （2） API 证书
- （3） API 证书序列号
- （4） API V3密钥

![](/storage/images/20221129/d69fefede4fdc16bf8782c0365ca4de6.png)

#### 二、前置步骤

------------

（1）进入项目目录，安装 [wechatpay-php](https://github.com/wechatpay-apiv3/wechatpay-php "wechatpay-php") composer包

composer require wechatpay/wechatpay

![](/storage/images/20221129/9cc46ba74b4313485decd1346af3fe0a.png)

（2）下载微信平台证书

![](/storage/images/20221129/1be702848f18f73d31dbe74abd6c353d.png)

执行 `composer exec CertificateDownloader.php` 查看说明。

//终端
    composer exec CertificateDownloader.php
    
    Usage: 微信支付平台证书下载工具 [-hV]
                        -f=<privateKeyFilePath> -k=<apiv3Key> -m=<merchantId>
                        -s=<serialNo> -o=[outputFilePath] -u=[baseUri]
    Options:
      -m, --mchid=<merchantId>   商户号
      -s, --serialno=<serialNo>  商户证书的序列号
      -f, --privatekey=<privateKeyFilePath>
                                 商户的私钥文件
      -k, --key=<apiv3Key>       APIv3密钥
      -o, --output=[outputFilePath]
                                 下载成功后保存证书的路径，可选，默认为临时文件目录夹
      -u, --baseuri=[baseUri]    接入点，可选，默认为 https://api.mch.weixin.qq.com/
      -V, --version              Print version information and exit.
      -h, --help                 Show this help message and exit.

平台证书下载命令

composer exec CertificateDownloader.php -- -k ${apiV3key} -m ${mchId} -f ${mchPrivateKeyFilePath} -s ${mchSerialNo} -o ${outputFilePath}
	
拼接参数下载平台证书。

composer exec CertificateDownloader.php --  -k Zrdj7VGaSPYNhV3密钥9X5nl2Ett308VEw -m 1632405354 -f /www/wwwroot/站点名/addons/epay/certs/apiclient_key.pem -s 77DA513E3B304C序列号B8C80C2131B7A47D317 -o /www/wwwroot/站点名/addons/epay/certs
	
`运行成功结果`

![](/storage/images/20221129/0959fee0eb6bc16060d05d8efb061df8.png)

`运行错误结果`

1/2是php禁用函数问题。3是git为安装的原因。

![](/storage/images/20221129/e08642f4226aeaec5cd5c2cb765f82c4.png)

#### 三、提现操作

------------
Composer包文档：[wechatpay-php](https://github.com/wechatpay-apiv3/wechatpay-php "wechatpay-php")
APIV3 官方文档：[微信商家付款到零钱](https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_2 "微信商家付款到零钱")

特别注意：wechatpay `链式表达`这块的说明

![](/storage/images/20221129/a26446051e1febc08a1600c7e609ce72.png)

提现：
- （1）控制器里引入：

use WeChatPay\Builder;
    use WeChatPay\Crypto\Rsa;
    use WeChatPay\Util\PemUtil;
	
- （2）提现方法

public function wxTransfer($params, $openid)
    {
        // 商户号
        $merchantId = '1619***739';
        // 从本地文件中加载「商户API私钥」，「商户API私钥」会用来生成请求的签名
        $merchantPrivateKeyFilePath = 'file://' . '/www/wwwroot/站点目录/addons/epay/certs/apiclient_key.pem';
        $merchantPrivateKeyInstance = Rsa::from($merchantPrivateKeyFilePath, Rsa::KEY_TYPE_PRIVATE);
        // 「商户API证书」的「证书序列号」
        $merchantCertificateSerial = '5C83F32F0E5134229****10382D8F0E251507';
        // 从本地文件中加载「微信支付平台证书」，用来验证微信支付应答的签名
        $platformCertificateFilePath = 'file://' . '/www/wwwroot/站点目录/addons/epay/certs/wechatpay_3CC107927233DDAACAE0F6D2177C78F066FF7527.pem';
        $platformPublicKeyInstance = Rsa::from($platformCertificateFilePath, Rsa::KEY_TYPE_PUBLIC);
        // 从「微信支付平台证书」中获取「证书序列号」
        $platformCertificateSerial = PemUtil::parseCertificateSerialNo($platformCertificateFilePath);
    
        // 构造一个 APIv3 客户端实例
        $instance = Builder::factory([
            'mchid'      => $merchantId,
            'serial'     => $merchantCertificateSerial,
            'privateKey' => $merchantPrivateKeyInstance,
            'certs'      => [
                $platformCertificateSerial => $platformPublicKeyInstance,
            ],
        ]);
    
        // 加密敏感信息
        $encryptor = static function (string $msg) use ($platformPublicKeyInstance): string {
            return \WeChatPay\Crypto\Rsa::encrypt($msg, $platformPublicKeyInstance);
        };
    
        // 商家转账到零钱
        $response = $instance
            ->chain('v3/transfer/batches')
            ->post(['json' => [
                'appid'                 => 'wx7ac5a73893c2c6b8',
                'out_batch_no'          => 'lddj' . $params['orderid'], //商户系统内部的商家批次单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一,
                'batch_name'            => date('Y-m',time()) . ' - 提现',       //该笔批量转账的名称
                'batch_remark'          => $params['name'] ."-". $params['memo'], //转账说明，UTF8编码，最多允许32个字符
                'total_amount'          => intval(strval($params['money'] * 100)), //转账总金额 单位为“分”
                'total_num'             => 1,
                'transfer_detail_list'  => [
                    [
                        'out_detail_no'     => $params['orderid'],
                        'transfer_amount'   => intval(strval($params['money'] * 100)),
                        'transfer_remark'   => $params['name'] ."-". $params['memo'],
                        'openid'            => $openid,
                        //'user_name'         => $encryptor($params['name']) // 金额超过`2000`才填写
                    ]
                ]
            ]]);
        return $response;
    }

#### 四、查询转账

------------
一样的步骤，调用API不同。

//签名 证书 序列号 -----
    //构建实例 -----
    
    // 商家明细单号查询明细单API
    // https://api.mch.weixin.qq.com/v3/transfer/batches/out-batch-no/x23zy545Bd5436/details/out-detail-no/plfk2020042013
    	$resp = $instance
    	->v3->transfer->batches->outBatchNo->_item1_->details->outDetailNo->_item2_
    	->get([
    		// 变量名 => 变量值
    		'item1' => 'lddj' . $row['orderid'],
    		'item2' =>  $row['orderid'],
    	]); 
    
    	$result = json_decode($resp->getBody(),true);
		
提现成功返回结果：

![](/storage/images/20221129/8e5c9aa9a8d790ff1adf5538bd714ab6.png)

提现失败返回结果：

失败返回的是错误码，可以去文档里整理出来存在数组里，然后拿返回的结果去匹配，从而返回给页面中文显示。。

// 金额 / 失败原因处理
    $result['transfer_amount'] = sprintf("%.2f",$result['transfer_amount']/100);
    if($result['detail_status'] == 'FAIL'){
    	$result['fail_reason'] = $this->model->reasonList($result['fail_reason']);
    }
    $result['update_time'] = date('Y-m-d H:i:s',strtotime($result['update_time']));
    
    $this->view->assign("row", $result);
    return $this->view->fetch();

我整理了一份

public function reasonList($value)
    {
        $list =  [
            'ACCOUNT_FROZEN'   => '账户冻结',     'REAL_NAME_CHECK_FAIL' => '用户未实名',
            'NAME_NOT_CORRECT' => '用户姓名校验失败', 'OPENID_INVALID'       => 'Openid校验失败',
            'TRANSFER_QUOTA_EXCEED' => '超过用户单笔收款额度', 'DAY_RECEIVED_QUOTA_EXCEED' => '超过用户单日收款额度',
            'MONTH_RECEIVED_QUOTA_EXCEED' => '超过用户单月收款额度', 'DAY_RECEIVED_COUNT_EXCEED' => '超过用户单日收款次数',
            'PRODUCT_AUTH_CHECK_FAIL' => '产品权限校验失败', 'OVERDUE_CLOSE' => '转账关闭',
            'ID_CARD_NOT_CORRECT' => '用户身份证校验失败', 'ACCOUNT_NOT_EXIST' => '用户账户不存在',
            'TRANSFER_RISK' => '转账存在风险', 'REALNAME_ACCOUNT_RECEIVED_QUOTA_EXCEED' => '用户账户收款受限，请引导用户在微信支付查看详情',
            'RECEIVE_ACCOUNT_NOT_PERMMIT' => '未配置该用户为转账收款人', 'PAYER_ACCOUNT_ABNORMAL' => '商户账户付款受限，可前往商户平台-违约记录获取解除功能限制指引',
            'PAYEE_ACCOUNT_ABNORMAL' => '用户账户收款异常，请引导用户完善其在微信支付的身份信息以继续收款', 'TRANSFER_REMARK_SET_FAIL' => '转账备注设置失败，请调整对应文案后重新再试',
        ];
        return isset($list[$value]) ? $list[$value] : '未知错误，请去 微信商户中心 - 交易中心 - 商家转账到零钱 - 查询具体原因';
    }

------------
	
另外具体的原因可以去商户号查询：

![](/storage/images/20221129/dd5fd091883a85690071c23e97895762.png)

![](/storage/images/20221129/158ef8bb04ebaddf23de5d01d0b343d7.png)

![](/storage/images/20221129/8e585822dcc1c0878f21eb3ff7b1dac1.png)

![](/storage/images/20221129/f0eeb317fb2d68bc872574ab224507bc.png)

Fastadmin 微信商家转账到零钱