微信扫码支付开发流程精讲-php版本(根据流程可改写其他语言版本)

306 阅读4分钟

我正在参加「掘金·启航计划」

说明:增加微信支付,是把自己系统的某一个订单基于微信实现付款后 并且修改自己系统订单状态的功能。此例假设自己系统已经做成所所有环节,就差付款这一块。

1.微信统一下单接口

1.1准备改内容

申请微信商户平台 申请后基于平台设置api 当前的微信商户平台版本提供两个密钥设置APIv2、APIv3。 注意:设置时保持这两个密钥32位。APIv2就是老版本的appSecret,APIv3作用和APIv2相当,增加了许多场景,用法基本一致,用哪一个都可以。

于是,准备环节我们拿到了: appSecret(APIv2或者APIv3) appid
mch_id

1.2微信商户平台的统一下单的算法简述

准备数据:

 $conf=[
        'appid' => $this->appid, //appID
        'mch_id'=> $this->mch_id,//商户号
        'device_info'=> 1000,
        'body'=>$body,//订单描述
        'nonce_str'=>$this->createNoncestr(), //不长于32位随机字符串 
        'out_trade_no'=>$out_trade_no,//订单号
        'trade_type'=>'NATIVE',//扫码支付 其他场景的固定参数参照管方参数
        'total_fee'=>$total_fee,//付款金额 这里的单位是分 付款1块钱 这里小填写 100
        'notify_url'=>'xxxxx' //回调地址 如付款后 调取短信通知的等可以参照(修改订单状态也可以用这个,但是 本次实例中 我们采纳付款金额调用订单状态付成功后 修改订单状态)
    ]; 
这里多讲一下trade_type:
JSAPI--JSAPI支付(或小程序支付)、
NATIVE--Native支付、
APP--app支付,
MWEB--H5支付, -> 【这个场景需要:在微信商家配置过一个付款域名+路径 ,你的返回 [mweb_url] => https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx22222222299422226aa3170000&package=1522224  需要在那个路径下用非微信浏览器打开的哦】
不同trade_type决定了调起支付的方式,请根据支付产品正确上传

生成签名

   拼接: key=appSecret&appid=xxxxx...    这个串串 我们叫它x
   加密:md5加密这个拼接串 y为 md5(x)             加密后我们叫它y
   大写:我们把y变成大写   我们叫它 signStr
   至此 我们得到sign
   
   

封装参数

 $conf=[
        'appid' => $this->appid, //appID
        'mch_id'=> $this->mch_id,//商户号
        'device_info'=> 1000,
        'body'=>$body,//订单描述
        'nonce_str'=>$this->createNoncestr(), //不长于32位随机字符串 
        'out_trade_no'=>$out_trade_no,//订单号
        'trade_type'=>'NATIVE',//扫码支付 其他场景的固定参数参照管方参数
        'total_fee'=>$total_fee,//付款金额 这里的单位是分 付款1块钱 这里小填写 100
        'notify_url'=>'xxxxx' ,//回调地址 如付款后 调取短信通知的等可以参照
        //(修改订单状态也可以用这个,
        //但是 本次实例中 我们采纳付款金额调用订单状态付成功后 修改订单状态)
        sign=>signStr
    ]; 

封装参数转xml

xml提交微信商户平台(api.mch.weixin.qq.com/pay/unified… 这个返回值也是xml 把它解析成所需要的对象在使用哦

2.统一下单后的处理code_url 变成qrCode 付款二维码

统一下单成功后 我们得到了code_url 鉴于,这个code_url 在微信商户平台存在时效性,我们最后把1.2的统一下单做成一个异步接口,这样我们定时刷新这个接口 就能即使得到活性的code_url 。 这里我们用到两个工具js jquery.min.js 自己找一个吧 这个太多了 qrcode.js blog.csdn.net/qq_17040587… 让你自己搜索资源自己下载,不是我风格! 这两个你都懒得找,我放着了 不用积分直接下载 download.csdn.net/download/qq…

定时请求统一下单和code_url 转换付款二维码后面附上html文件

3.付款页我们设置定时状态查询

这个接口 跟微信统一下单基本一样,参数略少了写,也需要生成sign 具体的参数看后面我的php实现类 这里的业务交互,就是船传订单号,订单号官方给了两个选择,就是可以为你自己系统生成的订单号查,也可以用微信商户对你的订单自动生成的订单号查,二选1就可以。具体的实现不再赘述,看我的实现类就可以,算法都一样,对照好了参数用自己的语言去实现就可以

4.检测付款成功后 订单状态修改

在介绍统一下单封装参数我们提到过这个参数:对它比较多的备注说明:

    'notify_url'=>'xxxxx' ,//回调地址 如付款后 调取短信通知的等可以参照
        //(修改订单状态也可以用这个,
        //但是 本次实例中 我们采纳付款金额调用订单状态付成功后 修改订单状态)

具体用那种场景修改付款后的订单状态根据你的业务需要处理吧。 1.统一下单后的回调接口 2.付款页面定时请求订单状态查询。

5. 代码实现

这里的后端我采纳的php框架larval来写的

5.1微信商户工具类:Weixin.php


<?php


namespace App\Common\WeixinPay;


class Weixin
{


    protected $appid = 'wxxxxxxxxxxxe';
    protected $appSecret = 'xxxxxxxxxxxxxxx2那个32为的自定义';
    // 商户号id
    protected $mch_id = 'xxxxxx商户号';


    protected $payUrl = 'https://api.mch.weixin.qq.com/pay/unifiedorder';
    // 回调 付款后的回调:发通知 发短信 修改订单状态 都可以
    protected $notify_url = 'http://127.0.0.1';

    //查询订单
    protected $orderQuery = 'https://api.mch.weixin.qq.com/pay/orderquery';


    /*
     * 微信支付统一下单
     */
    public function wxpay($total_fee, $out_trade_no, $body){

        $xml = $this->arrayToXml($this->getOptions($total_fee, $out_trade_no, $body));

        // 微信支付post提交
        $xmlData = $this->postXmlCurl($xml, $this->payUrl);
        $array_data = json_decode(json_encode(simplexml_load_string($xmlData, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
        if($array_data['return_code'] == 'SUCCESS'){
            return  $array_data;
        }else{
            return $array_data;
        }
    }

    /*
     * 设置统一下单参数
     * $total_fee  总金额
     * $out_trade_no  订单号
     * $body  商品描述
     */
    public function getOptions($total_fee, $out_trade_no, $body){
        $conf=[
            'appid' => $this->appid,
            'mch_id'=> $this->mch_id,
            'device_info'=> 1000,
            'body'=>$body,
            'nonce_str'=>$this->createNoncestr(),
            'out_trade_no'=>$out_trade_no,
            'trade_type'=>'NATIVE',
            'total_fee'=>$total_fee,
            'notify_url'=>'xxxxx'
        ];
        $conf['sign'] = $this->getSign($conf);

        return $conf;
    }

    //作用:产生随机字符串,不长于32位
    private function createNoncestr($length = 32) {
        $chars = "abcdefghijklmnopqrstuvwxyz0123456789";
        $str = "";
        for ($i = 0; $i < $length; $i++) {
            $str .= substr($chars, mt_rand(0, strlen($chars) - 1), 1);
        }
        return $str;
    }

    /**
     *  作用:生成签名
     */
    private function getSign($Parameters) {
        //签名步骤一:按字典序排序参数
        ksort($Parameters);
        $String = $this->formatBizQueryParaMap($Parameters, false);

//        echo '【string1】'.$String.'</br>';exit;
        //签名步骤二:在string后加入KEY
        $String = $String . "&key=" . $this->appSecret;
//         echo "【string2】".$String."</br>";exit;
        //签名步骤三:MD5加密
        $String = md5($String);
        //echo "【string3】 ".$String."</br>";
        //签名步骤四:所有字符转为大写
        $result_ = strtoupper($String);
//        echo "【result】 ".$result_."</br>";exit;
        return $result_;
    }

    /**
     *  作用:格式化参数,签名过程拼接字符串需要使用
     */
    private function formatBizQueryParaMap($paraMap, $urlencode) {
        $buff = "";
        ksort($paraMap);
        foreach ($paraMap as $k => $v) {
            if ($urlencode) {
                $v = urlencode($v);
            }
            $buff .= $k . "=" . $v . "&";
        }
        $reqPar = '';
        if (strlen($buff) > 0) {
            $reqPar = substr($buff, 0, strlen($buff) - 1);
        }
        return $reqPar;
    }

    /**
     *  作用:array转xml
     */
    private function arrayToXml($arr) {
        $xml = "<xml>";
        foreach ($arr as $key => $val) {
            if (is_numeric($val)) {
                $xml .= "<" . $key . ">" . $val . "</" . $key . ">";
            } else {
                $xml .= "<" . $key . "><![CDATA[" . $val . "]]></" . $key . ">";
            }
        }
        $xml .= "</xml>";
        return $xml;
    }
    function xmlToArray($xml){
        if (file_exists($xml)) {
            libxml_disable_entity_loader(false);
            $xml_string = simplexml_load_file($xml,'SimpleXMLElement', LIBXML_NOCDATA);
        }else{
            libxml_disable_entity_loader(true);
            $xml_string = simplexml_load_string($xml,'SimpleXMLElement', LIBXML_NOCDATA);

        }
        $result = json_decode(json_encode($xml_string),true);

        return $result;

    }
    /**
     *  作用:以post方式提交xml到对应的接口url
     */
    private function postXmlCurl($xml, $url, $second = 30) {
        //初始化curl
        $ch = curl_init();
        //设置超时
        curl_setopt($ch, CURLOPT_TIMEOUT, $second);
        //这里设置代理,如果有的话
        //curl_setopt($ch,CURLOPT_PROXY, '8.8.8.8');
        //curl_setopt($ch,CURLOPT_PROXYPORT, 8080);
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
        //设置header
        curl_setopt($ch, CURLOPT_HEADER, FALSE);
        //要求结果为字符串且输出到屏幕上
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
        //post提交方式
        curl_setopt($ch, CURLOPT_POST, TRUE);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
        //运行curl
        $data = curl_exec($ch);
        curl_close($ch);

        //返回结果
        if ($data) {
            return $data;
        } else {
            $error = curl_errno($ch);
            curl_close($ch);
            return false;
        }
    }

    /**
     * 微信查询订单状态
     */
    public function orderQuery( $out_trade_no){

        $xml = $this->arrayToXml($this->getOptionsQuery( $out_trade_no));

        // 微信支付post提交
        $xmlData = $this->postXmlCurl($xml, $this->orderQuery);
        $array_data = json_decode(json_encode(simplexml_load_string($xmlData, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
        return $array_data;
    }
     //查询订单数据接口
    public function getOptionsQuery( $out_trade_no){
        $conf=[
            'appid' => $this->appid,
            'mch_id'=> $this->mch_id,
            'device_info'=> 1000,
            'nonce_str'=>$this->createNoncestr(),
            'out_trade_no'=>$out_trade_no,

        ];
        $conf['sign'] = $this->getSign($conf);

        return $conf;
    }
}

5.2调用测试类:TestController.php

namespace App\Http\Controllers;
use App\Common\WeixinPay\Weixin;
class TestController extends Controller
{

    public function  test(){
        $wxpay = new Weixin();
        $res = $wxpay->wxpay(1000,"xxxx-xxx","xxxx");
        print_r($res);
    }
    public function index() {
        return view('test.pay');
    }



    /**
     * 统一下单,生成二维码
     */
    public function getQrUrl() {
        //调用统一下单API
         $wxpay = new Weixin();
//        $arr = $wxpay->wxpay(1,"xxxx-1s","xxxx");
        $arr = $wxpay->wxpay(1,"xxxx-1s","xxxx");
        $backData = [
            'code' => '200',
        ];
        if (!empty($arr['code_url'])) {
            $backData['code_url'] = $arr['code_url'];
        } else {
            $backData['code'] =201;
        }
        return $backData;
    }
    /**
     *  //查询订单反馈
     */
    public function queryOrder() {
        $wxpay = new Weixin();
        $arr = $wxpay->orderQuery("xxxx-1s");
        return $arr;

    }

        //查询订单反馈
        /**
         * Array ( [return_code] => SUCCESS
         * [return_msg] => OK
         * [result_code] => SUCCESS
         * [mch_id] => 162xxxxx1745
         * [appid] => wx2xxxxxxxxxxxxxx74e
         * [openid] => oH6lBXXXXXXXXXXXXXXXXXXXXXuLp_I
         * [is_subscribe] => Y [device_info] => 1000
         * [trade_type] => NATIVE
         * [trade_state] => SUCCESS
         * [bank_type] => OTHERS 
         * [total_fee] => 1
         * [fee_type] => CNY 
         * [cash_fee] => 1 
         * [cash_fee_type] => CNY
         * [transaction_id] => 42xxxxxxxxxxxxxxx79
         * [out_trade_no] => xxxx-1s
         * [attach] => Array ( )
         * [time_end] => 20221012164025
         * [trade_state_desc] => 支付成功
         * [nonce_str] => F93PXXXXXXXrz
         * [sign] => 09723xxxxxxxxxxxxxxxxxxxx22F2781
         * )
         */



5.3路由配置:laravel\routes\web.php

Route::any("/tx","TestController@index");
Route::any("/pay","TestController@getQrUrl");
Route::any("/cq","TestController@queryOrder");

5.4模版:pay.blade.php

<!DOCTYPE html>
<html>

<head>
    <title>TODO supply a title</title>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <script type="text/javascript" src="/common/js/jquery.js"></script>
    <script type="text/javascript" src="/common/js/qrcode.js"></script>
</head>
<body>
<div id="qrcode" style="width:100px; height:100px; margin-top:15px;"></div>
<script type="text/javascript">


    function getQrcode(){
        $.ajax({
            url:"/pay",
            type:"get",
            datatype:"json",
            success:function(res){
                if(res.code =='200'){
                    qrcode.makeCode(res.code_url);
                }else{
                    $("#qrcode").html("下单失败")
                }

            }
        });
    }
    function checkOrder(){
        $.ajax({
            url:"/cq",
            type:"get",
            datatype:"json",
            success:function(res){

                if(res!=undefined && res.trade_state!=undefined && res.trade_state=='SUCCESS'){
                    //支付成功
                    console.log("支付成功 跳页")
                }

            }
        });
    }
    var qrcode = new QRCode(document.getElementById("qrcode"));

    function makeCode (qrcodeUrl) {
        qrcode.makeCode(qrcodeUrl);
    }
    $(function () {
        getQrcode();
    })

    $(window).load(function() {
        setInterval("getQrcode()",120000);//每隔两分钟刷新一下付款码    //付款款二维码放置过期

        setInterval("checkOrder()",3000);//每隔两3秒检查一下订单

    })

</script>
</body>
</html>