开源微信微信支付V3接口调用和PHP开源实现

1、概述

支付功能是软件服务的关键一环，需要用户、支付应用、服务商和支付平台共同参与完成。为此，支付平台开放基础支付API，并提供常用开发语言SDK供开发者使用；支付服务商和软件开发者基于API和SDK根据业务场景开发具体支付业务。但是，从基础支付API、SDK到最终实现支付的过程比较复杂，需要一套简洁的实现框架和更高层的工具。本文以微信支付V3为基础，设计一套前后端分离支付框架，并提供开源实现（奇辰Open-API），做到支付功能开箱即用。

1.1支付服务参与者

• 支付平台：微信支付、支付宝等第三方平台；
• 服务商：具备基于支付平台基础功能提供支付服务的商家；
• 应用：由服务商提供或者自研的具备支付功能应用，包括H5、小程序、APP等；
• 用户：使用支付应用功能的人。

本文档主要面向服务商或者具备自研能力的应用开发者。

1.2难点关键技术

• 通用支付流程架构：管理员支付配置，用户从前端使用支付功能，后端闭环支付业务流程。
• 开箱即用API：通过简单的API调用即可完成业务所需支付功能。

2、通用支付架构

设计前后端分离通用支付架构如下图所示：

 基于前后端分离开源奇辰Open-API框架的后端支付服务实现后端支付业务，由开源框架后端服务完成和第三方微信支付平台的调用和回调工作，开发者不必再关注这方面的工作，可以把重心放在支付业务侧； 基于开源前端基础框架实现所需的支付应用和支付后台。在这个支付架构下，管理员通过支付台调用后端支付业务进行支付设置；用户支付应用端使用支付功能。

3、微信支付V3开源PHP实现框架

3.1支付设置

微信支付V3所有接口功能基于证书进行实现，有两类证书需要加以区分：商户API证书是每个微信商户自身的证书，另一类是微信支付平台证书；关于两类证书详情请参考微信支付官方文档。在 开源奇辰Open-API框架已经对证书管理进行了封装，开发者不再需要进行证书相关业务的开发。

1. 先设置微信支付商户号、商户密钥，上传商户API证书三个文件；
2. 完成前面设置，可以直接在后台获取微信支付平台证书。每个商户对应的微信支付平台证书不同，开源框架已经封装了微信支付平台证书管理，开发者不再需要关注此项功能开发。 

3.2支付调用

管理员完成微信支付设置后，前端应用可以调用封装好的接口发起支付。

• 调用接口

调用方式：HTTP、HTTPS

api: pay/wx/pay

HTTP请求方法：POST

• 接口实现

后端封装的接口实现如下：

1.  
   public function pay(Request $request)
2.  
   {
3.  
   $instance = Init::getInstance();
4.  
   $conf = ConfModel::first();
5.  
   $resp = $instance
6.  
   ->v3->pay->transactions->jsapi
7.  
   ->post(['json' => [
8.  
   'mchid' => $conf->mchid,
9.  
   'out_trade_no' => Sn::build_order_no(),
10.  
    'appid' => $conf->miniapp_appid,
11.  
    'description' => '奇辰Open-API微信支付',
12.  
    'notify_url' => env('HOST_URL') . '/pay/wx/notify',
13.  
    'amount' => [
14.  
    'total' => 1,
15.  
    'currency' => 'CNY'
16.  
    ],
17.  
    'payer' => [
18.  
    'openid' => $request->input('openid')
19.  
    ]
20.  
    ]]);
21.  
    $jsapi_result = json_decode($resp->getBody()->getContents());
22.  
    // 从本地文件中加载「商户API私钥」，「商户API私钥」会用来生成请求的签名
23.  
    $merchantPrivateKeyFilePath = 'file://' . env('ATTACHMENT_ROOT') . $conf->key_file;
24.  
    $merchantPrivateKeyInstance = Rsa::from($merchantPrivateKeyFilePath, Rsa::KEY_TYPE_PRIVATE);
25.  
    $params = [
26.  
    'appId' => $conf->miniapp_appid,
27.  
    'timeStamp' => (string)Formatter::timestamp(),
28.  
    'nonceStr' => Formatter::nonce(),
29.  
    'package' => 'prepay_id=' . $jsapi_result->prepay_id,
30.  
    ];
31.  
    $params = ['paySign' => Rsa::sign(
32.  
    Formatter::joinedByLineFeed(...array_values($params)),
33.  
    $merchantPrivateKeyInstance
34.  
    ), 'signType' => 'RSA'];
35.  
     
36.  
    $res = ResultTool::success();
37.  
    $res['data']['params'] = $params;
38.  
    return $res;
39.  
    }

代码第3行调用微信支付初始化函数获取微信支付实例，第12行设置支付回调接口，第18行设置接口参数传入的微信openid。接口返回前端调起支付所需的js参数，如下：

1.  
   pay() {
2.  
   let user_info = uni.getStorageSync('user_info')
3.  
   wxPay({
4.  
   openid: user_info.openid
5.  
   }).then(res => {
6.  
   if (res.errorCode == 200) {
7.  
   let params = res.data
8.  
   wx.requestPayment({
9.  
   timeStamp: params.timeStamp,
10.  
    nonceStr: params.nonceStr,
11.  
    package: params.package,
12.  
    signType: params.signType,
13.  
    paySign: params.paySign,
14.  
    success(res) {
15.  
    console.log(res)
16.  
    },
17.  
    fail(res) {
18.  
    console.log(res)
19.  
    }
20.  
    })
21.  
    }
22.  
    })
23.  
    }

前端wxPay函数在第9-13行获取后端返回的支付参数params，前端调用wx.requrestPayment函数调起支付如下图所示：

 3.3支付回调

支付完成后，前面支付设置的回调接口能收到相关支付信息。

• 回调接口

调用方式：HTTP、HTTPS

api: pay/wx/notify

HTTP请求方法：POST

• 接口实现

后端封装的接口实现如下：

1.  
   public function callback(Request $request)
2.  
   {
3.  
   $inWechatpaySignature = $request->header('Wechatpay-Signature'); // 请根据实际情况获取
4.  
   $inWechatpayTimestamp = $request->header('Wechatpay-Timestamp'); // 请根据实际情况获取
5.  
   $inWechatpaySerial = $request->header('Wechatpay-Serial'); // 请根据实际情况获取
6.  
   $inWechatpayNonce = $request->header('Wechatpay-Nonce'); // 请根据实际情况获取
7.  
   $inBody = file_get_contents('php://input'); // 请根据实际情况获取，例如: file_get_contents('php://input');
8.  
    
9.  
   $conf = ConfModel::first();
10.  
    $apiv3Key = $conf->signkey; // 在商户平台上设置的APIv3密钥
11.  
     
12.  
    // 根据通知的平台证书序列号，查询本地平台证书文件，
13.  
    // 假定为 `/path/to/wechatpay/inWechatpaySerial.pem`
14.  
    $platformPublicKeyInstance = Rsa::from('file://' . env('ATTACHMENT_ROOT') . 'wxpay/' . 'wechatpay_' . $inWechatpaySerial . '.pem', Rsa::KEY_TYPE_PUBLIC);
15.  
     
16.  
    // 检查通知时间偏移量，允许5分钟之内的偏移
17.  
    $timeOffsetStatus = 300 >= abs(Formatter::timestamp() - (int)$inWechatpayTimestamp);
18.  
    $verifiedStatus = Rsa::verify(
19.  
    // 构造验签名串
20.  
    Formatter::joinedByLineFeed($inWechatpayTimestamp, $inWechatpayNonce, $inBody),
21.  
    $inWechatpaySignature,
22.  
    $platformPublicKeyInstance
23.  
    );
24.  
    if ($timeOffsetStatus && $verifiedStatus) {
25.  
    // 转换通知的JSON文本消息为PHP Array数组
26.  
    $inBodyArray = (array)json_decode($inBody, true);
27.  
    // 使用PHP7的数据解构语法，从Array中解构并赋值变量
28.  
    ['resource' => [
29.  
    'ciphertext' => $ciphertext,
30.  
    'nonce' => $nonce,
31.  
    'associated_data' => $aad
32.  
    ]] = $inBodyArray;
33.  
    // 加密文本消息解密
34.  
    $inBodyResource = AesGcm::decrypt($ciphertext, $apiv3Key, $nonce, $aad);
35.  
    // 把解密后的文本转换为PHP Array数组
36.  
    $inBodyResourceArray = (array)json_decode($inBodyResource, true);
37.  
    // print_r($inBodyResourceArray);// 打印解密后的结果
38.  
    }
39.  
     
40.  
    echo 'success';
41.  
    }

在回调接口的第36行$inBodyResourceArray里面可以开发业务所需要的支付回调功能。

 4、更多

开源项目：Open-Api

更多信息：www.lokei.cn

这篇好文章是转载于：学新通技术网