🎈 申請商户號

• 申請地址： https://pay.weixin.qq.com/
• 如果你還沒有微信商户號，請點擊上面的鏈接進行申請，如果已經有了，可以跳過這一步

🎈 申請商户證書

• 首先點擊 賬户中心 ▶ API安全 ▶ 申請API證書
• 申請詳細步驟： https://kf.qq.com/faq/161222NneAJf161222U7fARv.html

🎈 設置APIv3密鑰

• 首先點擊 賬户中心 ▶ API安全 ▶ 設置APIv3密鑰 ▶ 設置
• 會看到有兩個密鑰，分別是 APIv2密鑰 和 APIv3密鑰，由於 APIv2密鑰 已經逐漸廢棄了，所以只需要申請 APIv3密鑰 即可
• 密鑰可由數字大小寫字母組合，輸入任意的 32 位字符，該密鑰需要保存好，供後面使用

// 生成32位的APIv3隨機密鑰
$chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';

echo substr(str_shuffle($chars), 0, $length);

🎈 下載 SDK 開發包

• 微信官方提供了 JAVA、PHP、GO 三種語言版本的開發庫，請根據自己開發語言選擇
• JAVA語言： wechatpay-java ‹推薦›、wechatpay-apache-httpclient
• PHP語言： wechatpay-php ‹推薦›、wechatpay-guzzle-middleware
• GO語言： wechatpay-go ‹推薦›
• 由於 php 實現支付相對簡單，所以我將以 php 作為支付的講解
• 首先使用 composer 安裝 sdk

# 初始化文件夾
composer init

# 推薦使用 PHP 包管理工具 Composer 安裝 SDK
composer require wechatpay/wechatpay

🎈 下載平台證書

• 平台證書跟上面申請的商户證書不是同一個東西，在後期請求中，平台證書和商户證書都要帶上
• 上面命令執行完之後，會有一個 vendor/bin/CertificateDownloader.php 文件
• 如果你是第一次申請平台證書，需要執行命令：php CertificateDownloader.php -k ${apiV3key} -m ${mchId} -f ${mchPrivateKeyFilePath} -s ${mchSerialNo} -o ${outputFilePath}
• -k： apiv3 秘鑰，上面自己設置的32位數的密鑰
• -m： 商户號，微信商户平台可以查詢
• -f： 微信商户API私鑰文件目錄，也就是第二步申請商户證書裏面生成的 apiclient_key.pem 路徑
• -s： 證書序列號，在 賬户中心 ▶ API安全 ▶ 管理證書 中可以看見，如果有多個證書，找到自己正在使用的證書序列號
• -o： 生成後的證書保存地址

cd vendor/bin/

php CertificateDownloader.php -k 241xxxxxxxxxxxxxxxxx44 -m 1xxxxxxx1 -f ../../cert/merchant/apiclient_key.pem -s Wxxxxxxxxxxxxxxxx4 -o  ../../cert/wechatpay/

🎈 關聯 AppID 賬號

• 因為使用的是微信支付，所以用户支付後，需要通過微信號通知用户支付的一些信息，所以需要在商户號下至少關聯一個公眾號

🎈 開通 H5 支付

• 點擊 產品中心 ▶ 我的產品 ▶ H5支付 ▶ 點擊開通
• 開通後，選擇 開發配置 ▶ H5支付域名 申請添加 H5支付域名
• 申請支付域名需要先做好產品的頁面，申請的時候需要有頁面的截圖，截圖中還要 截取到域名，支付的審核算是很嚴格的，如果申請不過，駁回後再申請，審核通過的時間會越來越長，所以最好一次性就把材料收集好，另外還要域名的備案的 IPC 截圖
• IPC 備案查詢地址： https://beian.miit.gov.cn/
• 關於域名的填寫，如果只填寫域名不填寫具體域名路徑，微信在支付的時候就只會校驗域名，這也是最方便的，因為域名下有多個項目有支付功能的話，就不需要重複添加了

🎈 H5支付流程

• H5支付是在微信以外的瀏覽器使用的，如果是微信內的話，使用的是 jsapi 支付
• 所以一般用户進入頁面的第一件事，就是檢測用户使用的環境是微信瀏覽器還是其他瀏覽器
• 前端傳一些用户挑選商品後的參數，並請求後端處理接口，後端應該將一些參數進行入庫，順便請求 H5 支付接口
• 接口應該返回跳轉鏈接 h5_url，如果你想用户付款之後到結果頁面，需要添加 redirect_url 參數，這個參數一定要用 encodeURIComponent 進行處理
• 由於官方在 jssapi 支付中説明，不要相信前端的 success 結果，所以需要在結果頁中，讓用户自動觸發查詢結果，因此需要返回後端生成的訂單號，用作在結果頁的用户手動點擊查詢

// 判斷是否微信瀏覽器
function isWeChat() {
    var ua = navigator.userAgent.toLowerCase();
    if (ua.match(/MicroMessenger/i) == 'micromessenger') {
        return true;
    } else {
        return false;
    }
}

if(isWeChat()) {
    // 是微信中打開的產品頁面
    alert('微信內不支持h5支付，請在外部瀏覽器打開頁面');
} else {
    // 非微信內打開的產品頁面，請求接口，獲取支付的跳轉鏈接
    // 前端用户選的產品，以及產品的金額，傳一些參數過去
    let params = {
        total: 2, // 單位：元
        description: 'Image形象店-深圳騰大-QQ公仔' // 產品的介紹
        // ....更多入庫參數
    };
    
    $.getJSON('後端接口地址/h5?' + $.param(params) + '&callback=?', function(res) {
        // 拉起微信支付界面，成功後會跳轉到redirect_url鏈接
        $(location).attr("href", res.data.h5_url + "&redirect_url=" + encodeURIComponent(`https://xxxxxx/finish?out_trade_no=${res.data.out_trade_no}`))
    });
}

<?php
// 僅僅用作展示，不可直接複製使用
require_once('../vendor/autoload.php');

use WeChatPay\Builder;
use WeChatPay\Crypto\Rsa;
use WeChatPay\Util\PemUtil;

// 接受參數，相當於原生的$_GET
$input = $request->only(['name', 'total', 'description', 'phone']);

// 生成商户訂單號
$out_trade_no = getOutTradeNo();

// 處理金額
// 由於微信使用的是分作為單位，所以前端傳的是元的話，需要轉換一下
$total = $input['total'] * 100;

// 商户號
$merchantId = '1xxxxxx1';

// 從本地文件中加載「商户API私鑰」，「商户API私鑰」會用來生成請求的簽名
$merchantPrivateKeyFilePath = 'file://../cert/merchant/apiclient_key.pem';
$merchantPrivateKeyInstance = Rsa::from($merchantPrivateKeyFilePath, Rsa::KEY_TYPE_PRIVATE);

// 「商户API證書」的「證書序列號」
$merchantCertificateSerial = '1xxxxxxxxxxxxxxxxxxxxx91';

// 從本地文件中加載「微信支付平台證書」，用來驗證微信支付應答的簽名
$platformCertificateFilePath = 'file://../cert/wechatpay/wechatpay_4xxxxxxxxxxxxxxxxxxx9.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,
    ],
]);


try {
    $resp = $instance
        ->chain('v3/pay/transactions/h5')
        ->post(['json' => [
            'mchid'        => $merchantId, // 商户號
            'out_trade_no' => $out_trade_no, // 商户訂單號
            'appid'        => '********換成跟商户號綁定的公眾號APPID**********',
            'description'  => $input['description'], //商品描述
            'notify_url'   => 'https://xxxxx/notify', // 用户支付後的回調地址，在這裏修改訂單的狀態
            'amount'       => [
                'total'    => $total, // 微信處理的單位是分
                'currency' => 'CNY'
            ],
            'scene_info' => [
                'payer_client_ip' => getClientIP(), // 有些框架有自帶獲取獲取客户端IP
                'h5_info' => [
                    'type' => 'Wap'
                ]
            ]
        ]]);
        
        
   // 如果請求成功，需要將一些參數進行入庫，這裏僅作演示，非正式數據入庫
   $response = Db::table('order')->insert([
       'name' => $input['name'],
       'description' => $input['description'],
       'total' => $input['total'],
       'phone' => $input['phone'],
       'trade_state' => 'START',
   ]);
   
   // 入庫成功後，將跳轉鏈接和訂單號傳給前端，前端拿到跳轉地址跳轉即可
   if($response) {
       return jsonp([
        'code' => 200,
        'msg' => '操作成功',
        'data' => [
              'out_trade_no' => $out_trade_no,
              'h5_url' => json_decode($resp->getBody(), true)['h5_url']
           ]
        ]);
   } else {
       return jsonp([
        'code' => 100,
        'msg' => '操作失敗'
       ]);
   }
} catch (\Exception $e) {
    // 進行錯誤處理
    if ($e instanceof \GuzzleHttp\Exception\RequestException && $e->hasResponse()) {
        $r = $e->getResponse();
        echo $r->getBody(), PHP_EOL, PHP_EOL, PHP_EOL;
    }
}


// 生成唯一商户訂單號，訂單號不能超過32位，並且在同一個商户下訂單號不能重複
// 如果併發不高，基本這樣生成就可以，不會有重複的情況出現的
function getOutTradeNo()
{
    $out_trade_no = date('ymdHis') . mt_rand(1000, 9999) . uniqid();
    return mb_substr($out_trade_no, 0, 32);
}

// 獲取客户端的IP
function getClientIP()
{
    if (@$_SERVER["HTTP_ALI_CDN_REAL_IP"]) {
        $ip = $_SERVER["HTTP_ALI_CDN_REAL_IP"];
    } elseif (@$_SERVER["HTTP_X_FORWARDED_FOR"] ?: false) {
        $ips = explode(',', $_SERVER["HTTP_X_FORWARDED_FOR"]);
        $ip = $ips[0];
    } elseif (@$_SERVER["HTTP_CDN_SRC_IP"] ?: false) {
        $ip = $_SERVER["HTTP_CDN_SRC_IP"];
    } elseif (getenv('HTTP_CLIENT_IP')) {
        $ip = getenv('HTTP_CLIENT_IP');
    } elseif (getenv('HTTP_X_FORWARDED')) {
        $ip = getenv('HTTP_X_FORWARDED');
    } elseif (getenv('HTTP_FORWARDED_FOR')) {
        $ip = getenv('HTTP_FORWARDED_FOR');
    } elseif (getenv('HTTP_FORWARDED')) {
        $ip = getenv('HTTP_FORWARDED');
    } else {
        $ip = $_SERVER['REMOTE_ADDR'];
    }

    $ip = str_replace(['::ffff:', '[', ']'], ['', '', ''], $ip);
    return $ip;
}

<?php
// 回調處理，當用户支付訂單後，微信會請求該接口，也就是上面在notify_url中填寫的接口
// 在這裏我們可以修改訂單的狀態啥的
public function notify()
{
    // 獲取參數
    $inBody = file_get_contents('php://input');

    // APIv3密鑰
    $apiv3Key = 'xxxxxxxxxxxx';

    // 轉換通知的JSON文本消息為PHP Array數組
    $inBodyArray = (array)json_decode($inBody, true);
    
    // 加密文本消息解密
    $inBodyResource = AesGcm::decrypt(
        $inBodyArray['resource']['ciphertext'],
        $apiv3Key,
        $inBodyArray['resource']['nonce'],
        $inBodyArray['resource']['associated_data']
    );

    // 把解密後的文本轉換為PHP Array數組
    $inBodyResourceArray = (array)json_decode($inBodyResource, true);

    try {
        // 獲取訂單信息
        $order = Db::table('order')->where('out_trade_no', $inBodyResourceArray['out_trade_no'])->first();

        Db::startTrans();
        if ($order) {
            // 修改order訂單的狀態
            Db::table('order')->where('id', $order['id'])->update([
                'openid' => $inBodyResourceArray['payer']['openid'],
                'trade_state' => $inBodyResourceArray['trade_state']
            ]);
            
            
            Db::table('payment')->insert([
                 'out_trade_no' => $inBodyResourceArray['out_trade_no'],
                'transaction_id' => $inBodyResourceArray['transaction_id'],
                'trade_type' => $inBodyResourceArray['trade_type'],
                'trade_state' => $inBodyResourceArray['trade_state'],
                'trade_state_desc' => $inBodyResourceArray['trade_state_desc'],
                'total_amount' => $inBodyResourceArray['amount']['total'],
                'bank_type' => $inBodyResourceArray['bank_type'],
                'success_time' => strtotime($inBodyResourceArray['success_time'])
            ]);

            Db::commit();
        } else {
            Db::rollback();
        }
    } catch (\Exception $e) {
        Db::rollback();
    }
}

🎈 開通 JSAPI 支付

• 點擊 產品中心 ▶ 我的產品 ▶ JSAPI支付 ▶ 點擊開通
• 開通後，選擇 開發配置 ▶ JSAPI支付域名 申請添加 JSAPI支付域名
• 關於申請支付域名的流程基本都差不多要求也差不多，看上面的 H5支付域名 申請就行，這裏就不過多贅述了

🎈 JSAPI 支付流程

• JSAPI支付是在微信內的瀏覽器使用的，如果用户是在微信外打開的話，需要提醒去微信內打開頁面
• JSAPI支付需要使用微信內置的 WeixinJSBridge.invoke 方法
• 由於 JSAPI 調用支付需要用到用户的 openid，所以需要想方設法在用户調用 JSAPI 之前獲取到 openid，點擊查看獲取 openid 的官方文檔
• 獲取用户 openid，需要先獲取 code，這個經常做微信業務的人都知道，那麼如何在用户無感知的情況下就獲取到 openid 呢
• 思路就是，一般支付最少會有3個頁面，這裏標註為a、b、c 三個頁面，通常是在 a 頁面挑選商品，在 b頁面確認商品，也就是付款頁面，c 頁面查詢支付狀態
• 由於 code 的存在時間只有5分鐘，所以註定 code 獲得後不能長時間不使用，也就是説用户一旦在某個頁面超過5分鐘，這個 code 就失效了，因此最好的方法就是獲取 code 後，立馬獲取 openid
• 那麼就應該設計成從a 頁面先跳轉到獲取 code 頁面再跳轉到 b 頁面，而在 b 頁面的一開始就去請求接口，獲取用户的 openid 即可
• 跳轉到 b 頁面後，鏈接後自動帶上 code參數，鏈接應該是 https://xxxx/b.html?code=xxxxxxxx

// a頁面，僅做邏輯演示，更加具體的邏輯需要自己完善
// 判斷是否微信瀏覽器
function isWeChat() {
    var ua = navigator.userAgent.toLowerCase();
    if (ua.match(/MicroMessenger/i) == 'micromessenger') {
        return true;
    } else {
        return false;
    }
}

if(!isWeChat()) {
    // 非微信內打開的產品頁面
    alert('微信外不支持JSAPI支付，請在微信中打開頁面');
    return false;
}

// 用户挑選完商品後跳轉，這裏appid需要上面跟商户綁定的公眾號appid
// 微信授權分為靜默授權和非靜默授權，其中非靜默授權，需要用户點擊確認授權後，才可以獲取code，
// 因為這裏主打一個用户無感知，而且我們只需要openid即可，所以我們只需要使用靜默授權即可
// 靜默授權可以獲取用户更多的信息，比如頭像、暱稱等，而靜默授權只能獲取openid，這點需要注意，具體情況選擇不同
// 非靜默授權
// $(location).attr('href', `https://open.weixin.qq.com/connect/oauth2/authorize?appid=xxxxxxxxxxx&redirect_uri=${encodeURIComponent('https://xxxx/b.html')}&response_type=code&scope=snsapi_userinfo#wechat_redirect`)
// 靜默授權
$(location).attr('href', `https://open.weixin.qq.com/connect/oauth2/authorize?appid=xxxxxxxxxxx&redirect_uri=${encodeURIComponent('https://xxxx/b.html')}&response_type=code&scope=snsapi_base#wechat_redirect`)

// b頁面，僅做邏輯演示，更加具體的邏輯需要自己完善
let openid = '';

// 獲取code, 請求接口獲取openid
function getParamUrl(name, url) {
  if (!url) url = location.href;
  if (url.indexOf('?') == -1) return '';

  try {
    var re = new RegExp("" + name + "=([^&?]*)", "ig");
    return ((url.match(re)) ? (decodeURIComponent(url.match(re)[0].substr(name.length + 1))) : '');
  } catch (_e) {
    return '';
  }
}

let code = getParamUrl('code');

$.getJSON('後端接口地址/openid?callback=?', function(res) {
    if(res.code == 200) {
        openid = res.data;
    } else {
        console.error(res.msg);
    }
})

// 用户確定訂單後，拉起支付
let params = {
    total: 2, // 單位：元
    description: 'Image形象店-深圳騰大-QQ公仔', // 產品的介紹
    openid: openid //用户的openid
    // ....更多入庫參數
};

$.getJSON('後端接口地址/jssapi?' + $.param(params) + '&callback=?', function(res) {
    WeixinJSBridge.invoke('getBrandWCPayRequest', {
      'appId': res.data.sign.appId,
      'timeStamp': res.data.sign.timeStamp,
      'nonceStr': res.data.sign.nonceStr,
      'package': res.data.sign.package,
      'signType': res.data.sign.signType,
      'paySign': res.data.sign.paySign
    }, function (response) {
      if (response.err_msg == "get_brand_wcpay_request:ok") {
        $(location).attr("href", `https://xxxxxx/finish?out_trade_no=${res.data.out_trade_no}`)
      } else {
        // 有些用户調起了支付，但是未付款取消的處理方式，你可以給他簡單簡單提示
        toast('支付異常取消')

        // 當然有些用户是誤操作，你可以提醒二次支付
        if(confirm('檢測到你操作有誤，是否重新支付?')) {
            WeixinJSBridge.invoke('getBrandWCPayRequest', {
                  'appId': res.data.sign.appId,
                  'timeStamp': res.data.sign.timeStamp,
                  'nonceStr': res.data.sign.nonceStr,
                  'package': res.data.sign.package,
                  'signType': res.data.sign.signType,
                  'paySign': res.data.sign.paySign
                }, function (response) {
                if (response.err_msg == "get_brand_wcpay_request:ok") {
                    $(location).attr("href", `https://xxxxxx/finish?out_trade_no=${res.data.out_trade_no}`)
                }
            })
        }
      }
    });
});

<?php
// 獲取用户的openid

$input = $request->only(['code']);

$response = getCurl("https://api.weixin.qq.com/sns/oauth2/access_token?appid={$this->appid}&secret={$this->secret}&code={$input['code']}&grant_type=authorization_code");

$openid = json_decode($response, true)['openid'];

// 返回openid
return jsonp([
    'code' => 200,
    'msg' => '獲取成功',
    'data' => $openid
]);


// 封裝的GET請求
function getCurl($url, $timeout = 5)
{
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
    $result = curl_exec($ch);
    curl_close($ch);

    return $result;
}

<?php
// 僅僅用作展示，不可直接複製使用
require_once('../vendor/autoload.php');

use WeChatPay\Builder;
use WeChatPay\Formatter;
use WeChatPay\Crypto\Rsa;
use WeChatPay\Util\PemUtil;

// 接受參數，相當於原生的$_GET，這裏會比h5支付多一個openid
$input = $request->only(['openid', 'name', 'total', 'description', 'phone']);

// 生成商户訂單號
$out_trade_no = getOutTradeNo();

// 處理金額
// 由於微信使用的是分作為單位，所以前端傳的是元的話，需要轉換一下
$total = $input['total'] * 100;

// 商户號
$merchantId = '1xxxxxx1';

// 從本地文件中加載「商户API私鑰」，「商户API私鑰」會用來生成請求的簽名
$merchantPrivateKeyFilePath = 'file://../cert/merchant/apiclient_key.pem';
$merchantPrivateKeyInstance = Rsa::from($merchantPrivateKeyFilePath, Rsa::KEY_TYPE_PRIVATE);

// 「商户API證書」的「證書序列號」
$merchantCertificateSerial = '1xxxxxxxxxxxxxxxxxxxxx91';

// 從本地文件中加載「微信支付平台證書」，用來驗證微信支付應答的簽名
$platformCertificateFilePath = 'file://../cert/wechatpay/wechatpay_4xxxxxxxxxxxxxxxxxxx9.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,
    ],
]);


try {
    // 調用 transactions/jsapi 接口後會生成prepay_id
    $resp = $this->instance()
        ->chain('v3/pay/transactions/jsapi')
        ->post(['json' => [
            'mchid'        => $merchantId, // 商户號
            'out_trade_no' => $out_trade_no, // 商户訂單號
            'appid'        => '********換成跟商户號綁定的公眾號APPID**********',
            'description'  => $input['description'], //商品描述
            'notify_url'   => 'https://xxxxx/notify', // 用户支付後的回調地址，在這裏修改訂單的狀態
            'amount' => [
                'total' => $total,
                'currency' => 'CNY'
            ],
            'payer' => [
                'openid' => $input['openid']
            ]
        ]]);
        
    // 需要根據prepay_id去生成加密的信息
    $prepay_id = json_decode($resp->getBody(), true)['prepay_id'];
    $sign = getSign($prepay_id);
        
   // 如果請求成功，需要將一些參數進行入庫，這裏僅作演示，非正式數據入庫
   $response = Db::table('order')->insert([
       'openid' => $input['openid'],
       'name' => $input['name'],
       'description' => $input['description'],
       'total' => $input['total'],
       'phone' => $input['phone'],
       'trade_state' => 'START',
   ]);
   
   // 入庫成功後，將跳轉鏈接和訂單號傳給前端，前端拿到跳轉地址跳轉即可
   if($response) {
       return jsonp([
        'code' => 200,
        'msg' => '操作成功',
        'data' => [
              'out_trade_no' => $out_trade_no,
              'sign' => $sign
           ]
        ]);
   } else {
       return jsonp([
        'code' => 100,
        'msg' => '操作失敗'
       ]);
   }
} catch (\Exception $e) {
    // 進行錯誤處理
    if ($e instanceof \GuzzleHttp\Exception\RequestException && $e->hasResponse()) {
        $r = $e->getResponse();
        echo $r->getBody(), PHP_EOL, PHP_EOL, PHP_EOL;
    }
}

// 獲取加密參數
function getSign($prepay_id)
{
    $merchantPrivateKeyInstance = Rsa::from($this->merchantPrivateKeyFilePath);

    $params = [
        'appId' => $this->appid,
        'timeStamp' => (string)Formatter::timestamp(),
        'nonceStr' => Formatter::nonce(),
        'package' => 'prepay_id=' . $prepay_id,
    ];

    $params += ['paySign' => Rsa::sign(
        Formatter::joinedByLineFeed(...array_values($params)),
        $merchantPrivateKeyInstance
    ), 'signType' => 'RSA'];

    return $params;
}

🎈 通用微信支付庫封裝

• 由於直接使用微信的支付庫，代碼非常的勻餘，所以封裝了一個微信支付庫
• 由於只針對一些業務的 api封裝，所以肯定不全，需要的可以自己添加需要的api
• 微信支付API接口列表： https://pay.weixin.qq.com/wiki/doc/apiv3/apis/index.shtml

<?php
/**
 * User: tinygeeker
 * Desc: 微信支付庫封裝
 * Date: 2023/08/10
 */

namespace App;

use App\Helper;
use WeChatPay\Builder;
use WeChatPay\Formatter;
use WeChatPay\Crypto\Rsa;
use WeChatPay\Util\PemUtil;

class WxPay
{
    // appid
    private $appid;

    // 商户號
    private $merchantId;

    // 商户API私鑰
    private $merchantPrivateKeyFilePath;

    // 證書序列號
    private $merchantCertificateSerial;

    // 微信支付平台證書
    private $platformCertificateFilePath;

    /**
     * @param $appid
     * @param $merchantId
     * @param $merchantCertificateSerial
     */
    public function __construct($appid = '', $merchantId = '', $merchantCertificateSerial = '')
    {
        $this->appid = $appid ?: '換成自己的APPID';
        $this->merchantId = $merchantId ?: '換成自己的商户號';
        $this->merchantCertificateSerial = $merchantCertificateSerial ?: '換成自己的證書序列號';

        $this->merchantPrivateKeyFilePath = 'file:///common/cert/merchant/apiclient_key.pem'; // 換成自己的
        $this->platformCertificateFilePath = 'file:///common/cert/wechatpay/wechatpay_xxx.pem'; // 換成自己的
    }

    /**
     * @return \WeChatPay\BuilderChainable
     */
    protected function instance()
    {
        $merchantPrivateKeyInstance = Rsa::from($this->merchantPrivateKeyFilePath, Rsa::KEY_TYPE_PRIVATE);
        $platformPublicKeyInstance = Rsa::from($this->platformCertificateFilePath, Rsa::KEY_TYPE_PUBLIC);

        $platformCertificateSerial = PemUtil::parseCertificateSerialNo($this->platformCertificateFilePath);

        $instance = Builder::factory([
            'mchid' => $this->merchantId,
            'serial' => $this->merchantCertificateSerial,
            'privateKey' => $merchantPrivateKeyInstance,
            'certs' => [
                $platformCertificateSerial => $platformPublicKeyInstance,
            ],
        ]);

        return $instance;
    }

    public function getSign($prepay_id)
    {
        $merchantPrivateKeyInstance = Rsa::from($this->merchantPrivateKeyFilePath);

        $params = [
            'appId' => $this->appid,
            'timeStamp' => (string)Formatter::timestamp(),
            'nonceStr' => Formatter::nonce(),
            'package' => 'prepay_id=' . $prepay_id,
        ];

        $params += ['paySign' => Rsa::sign(
            Formatter::joinedByLineFeed(...array_values($params)),
            $merchantPrivateKeyInstance
        ), 'signType' => 'RSA'];

        return $params;
    }

    public function checkOutTradeNo($out_trade_no)
    {
        try {
            $resp = $this->instance()
                ->v3->pay->transactions->outTradeNo->_out_trade_no_
                ->get([
                    // Query 參數
                    'query' => ['mchid' => $this->merchantId],
                    // 變量名 => 變量值
                    'out_trade_no' => $out_trade_no,
                ]);

            return $resp->getBody();
        } catch (\Exception $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;
        }
    }
    
    // h5下單
    public function h5($total, $out_trade_no, $description, $notify_url)
    {
        try {
            $resp = $this->instance()
                ->chain('v3/pay/transactions/h5')
                ->post(['json' => [
                    'mchid' => $this->merchantId,
                    'out_trade_no' => $out_trade_no,
                    'appid' => $this->appid,
                    'description' => $description,
                    'notify_url' => $notify_url,
                    'amount' => [
                        'total' => $total,
                        'currency' => 'CNY'
                    ],
                    'scene_info' => [
                        'payer_client_ip' => Helper::getClientIp(),
                        'h5_info' => [
                            'type' => 'Wap'
                        ]
                    ]
                ]]);

            return $resp->getBody();
        } catch (\Exception $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;
        }
    }
    
    // jsapi下單
    public function jsapi($openid, $total, $out_trade_no, $description, $notify_url)
    {
        try {
            $resp = $this->instance()
                ->chain('v3/pay/transactions/jsapi')
                ->post(['json' => [
                    'mchid' => $this->merchantId,
                    'out_trade_no' => $out_trade_no,
                    'appid' => $this->appid,
                    'description' => $description,
                    'notify_url' => $notify_url,
                    'amount' => [
                        'total' => $total,
                        'currency' => 'CNY'
                    ],
                    'payer' => [
                        'openid' => $openid
                    ]
                ]]);

            return $resp->getBody();
        } catch (\Exception $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;
        }
    }
    
    
   // todo... 更多接口可根據官方文檔列表自行添加
}

<?php
/**
 * User: tinygeeker
 * Desc: 工具庫
 * Date: 2023/08/10
 */
 
namespace App;

class Helper
{
    /**
     * @return array|mixed|string|string[]
     */
    static public function getClientIP()
    {
        if (@$_SERVER["HTTP_ALI_CDN_REAL_IP"]) {
            $ip = $_SERVER["HTTP_ALI_CDN_REAL_IP"];
        } elseif (@$_SERVER["HTTP_X_FORWARDED_FOR"] ?: false) {
            $ips = explode(',', $_SERVER["HTTP_X_FORWARDED_FOR"]);
            $ip = $ips[0];
        } elseif (@$_SERVER["HTTP_CDN_SRC_IP"] ?: false) {
            $ip = $_SERVER["HTTP_CDN_SRC_IP"];
        } elseif (getenv('HTTP_CLIENT_IP')) {
            $ip = getenv('HTTP_CLIENT_IP');
        } elseif (getenv('HTTP_X_FORWARDED')) {
            $ip = getenv('HTTP_X_FORWARDED');
        } elseif (getenv('HTTP_FORWARDED_FOR')) {
            $ip = getenv('HTTP_FORWARDED_FOR');
        } elseif (getenv('HTTP_FORWARDED')) {
            $ip = getenv('HTTP_FORWARDED');
        } else {
            $ip = $_SERVER['REMOTE_ADDR'];
        }

        $ip = str_replace(['::ffff:', '[', ']'], ['', '', ''], $ip);
        return $ip;
    }

    /**
     * @param $length
     * @param $type
     * @return false|string
     */
    static public function createRandomStr($length = 32, $type = 0)
    {
        switch ($type) {
            case 1:
                $chars = '0123456789';
                break;
            case 2:
                $chars = 'abcdefghijklmnopqrstuvwxyz';
                break;
            case 3:
                $chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
                break;
            case 4:
                $chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
                break;
            case 5:
                $chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
                break;
            default:
                $chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
                break;
        }

        return substr(str_shuffle($chars), 0, $length);
    }

    /**
     * @param $url
     * @param $timeout
     * @return bool|string
     */
    static public function getCurl($url, $timeout = 5)
    {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_HEADER, 0);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
        $result = curl_exec($ch);
        curl_close($ch);

        return $result;
    }

    /**
     * @param $url
     * @param $data
     * @param $header
     * @param $timeout
     * @return bool|string
     */
    static public function postCurl($url, $data, $header = [], $timeout = 5)
    {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        if ($header) {
            curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
        }
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
        $result = curl_exec($ch);
        curl_close($ch);

        return $result;
    }
}