微信H5支付(手机浏览器请求)

2,028 阅读3分钟

最近在做一个微信H5支付的功能,开发中遇到了一些问题,网上相关的资料比较少,在此做下总结以供参考。

一、功能需求

手机浏览器页面发起产品购买请求,调起微信支付,支付完成后返回购买页面展示支付结果。
(手机浏览器->微信app->手机浏览器)

二、关键思路详解

微信参考文档
其实微信文档已经把流程步骤列出来了,按照步骤就可以实现了,下面给出一些关键步骤及注意事项

1、用户点击页面购买按钮,向自己服务器后端接口发起购买请求并调起微信支付。这里需要注意的是,想要调起微信支付,需要后端微信发起统一下单,成功后返回结果有mweb_url字段,该字段的值是一个URL,为支付跳转链接。

请求跳转

a、后端接口直接跳转,后端发起统一下单获取mweb_url后直接redirect
b、前端页面用js跳转,后端将mweb_url返回给前端,前端用js跳转

function pay() {         $.ajax({               type: "POST",//方法类型               dataType: "json",//预期服务器返回的数据类型               url: "www.example.com/pay.php",//url               data: {'oid':oid},                       success: function (mweb_url) {                        window.location.href=mweb_url//获取后跳转                    },                    error : function() {                        alert("异常");                    }                });}
回调页面

后端发起统一下单获得的mweb_url,需要在其后面拼接redirect_url参数,并对redirect_url进行urlencode处理,来指定回调页面,如果未指定会报商家参数格式有误

<?php/**  *后端支付接口(以下代码省略了部分只给出大概逻辑不能直接使用)  *有#####的注释需要留意  **/use ....class pay{  /**     * 预支付     */    public function prepay(){        //微信支付类        $wxFactory = new WxFactory();        //统一下单所需参数(根据自己实际需求定义)        $body = '购买商品';        $notifyUrl = 'http://www.example.com/Callback.php';//微信支付异步回调        $tradeType = 'MWEB';        $amount = 1;        $time = time();        $out_trade_no = $time.sprintf('%08s',mt_rand(10, 999999));        if( $amount <= 0 ){            return new ApiResponse(['code' =>-1,'msg' =>'支付金额不得小于0']);//json类        }        try {            $payment = $wxFactory->getObj('\wx\payment');//调用统一下单接口            //参数            $params = array(                    'trade_type'=>$tradeType,                    'body'=>$body,                    'notify_url'=>$notifyUrl,                    'out_trade_no'=>$out_trade_no,                    'total_fee'=>$amount,//                 'spbill_create_ip'=>$_SERVER['REMOTE_ADDR'],  #####刚开始使用该方法获取ip结果报错,后面采用下面方法获取IP,得以解决                    'spbill_create_ip'=>$this->get_client_ip()            );            //预支付返回结果            $result = $payment->prepay($params);            $redirect_url  = 'http://www.example.com/show.php?';// #####回调地址,该地址需要是商户号后台提交的授权域名,如果不是请求跳转是需要伪造referer,不建议伪造.            $redirect_url .= 'order='.$out_trade_no;//####回调所需参数支付id,            $mweb_url = $result['mweb_url'].'&redirect_url='.urlencode($redirect_url);//####拼接回调地址            //返回mweb_url            return new ApiResponse(['code' =>0,'mweb_url'=>$data]);        }catch ( \WxServerException $e ){            //支付不成功会以异常形式返回            return new ApiResponse(['code' =>-1,'msg' =>$e->getMessage()]);        }    }    //获取IP地址    private function get_client_ip(){        if(getenv('HTTP_CLIENT_IP') && strcasecmp(getenv('HTTP_CLIENT_IP'), 'unknown')) {            $ip = getenv('HTTP_CLIENT_IP');        } elseif(getenv('HTTP_X_FORWARDED_FOR') && strcasecmp(getenv('HTTP_X_FORWARDED_FOR'), 'unknown')) {            $ip = getenv('HTTP_X_FORWARDED_FOR');        } elseif(getenv('REMOTE_ADDR') && strcasecmp(getenv('REMOTE_ADDR'), 'unknown')) {            $ip = getenv('REMOTE_ADDR');        } elseif(isset($_SERVER['REMOTE_ADDR']) && $_SERVER['REMOTE_ADDR'] && strcasecmp($_SERVER['REMOTE_ADDR'], 'unknown')) {            $ip = $_SERVER['REMOTE_ADDR'];        }        return preg_match ( '/[\d\.]{7,15}/', $ip, $matches ) ? $matches [0] : '';    }}

2、用户在微信中间页面操作后(支付或取消支付)会回跳到我们指定的回调地址,并带上我们拼装的参数。根据URL中的参数,前端页面请求后端接口查询支付结果(服务器根据支付订单id向微信发起查询),然后展示给用户。(根据微信文档,由于设置redirect_url后,回跳指定页面的操作可能发生在:1,微信支付中间页调起微信收银台后超过5秒 2,用户点击“取消支付“或支付完成后点“完成”按钮。因此无法保证页面回跳时,支付流程已结束,所以商户设置的redirect_url地址不能自动执行查单操作,应让用户去点击按钮触发查单操作。回跳页面展示效果可参考下图)

3、微信支付异步通知回调地址。统一下单成功后,微信会异步回调,统一下单时参数notify_url所填地址,该异步回调是用于通知服务器端,用户所生成的预支付订单是否支付完成。在做该功能的时候发现微信并有时候没有异步调用该接口,所以第2点提到的需要主动去调用后端接口查询就很有必要,如果担心主动调用查询出错,还可以写一个后端脚本定时去查询用户预支付订单情况。

三、总结

1、参照微信文档,文档中给出了详细的流程步骤。
2、mweb_url后必须拼接redirect_url,并且redirect_url必须授权,否则会报错
3、支付流程结束跳转回页面,展示支付结果,需要让用户主动触发查单操作。