uniapp 开发App使用微信H5支付解决方案

    • 1、开通h5支付
    • 2、前端部分
      • 2.1、请求h5支付接口
      • 2.2、 可能遇到的问题
    • 3、后端部分
      • 3.1 支付接口
      • 3.2 微信订单支付状态查询
      • 3.3 其余部分相关代码块

我们在开发app常常需要接入支付功能,但是有时候出于包体积或审核的因素,并不想接入支付相关的sdk,这个时候,就可以考虑使用h5支付完成购买服务,只需要访问后端返回的h5支付链接即可,便捷而简单。

话不多说,进入正题!

1、开通h5支付

前往微信商户平台 - 产品中心 - 我的产品 - 支付产品 - h5支付,申请开通h5支付,要审核1-7天,没问题的话一般两三天就能完成审核。

2、前端部分

2.1、请求h5支付接口

注意两个点:
1、先下单再进行支付,下单逻辑不同的项目业务逻辑也不同,故这里不多做阐述;
2、微信h5支付返回的mweb_url,前端直接访问,会报错:商家参数格式有误,请联系商家解决。解决方案是需要设置正确的Refere,具体看下方代码

// 发起支付请求, order_no为订单号
requestPay(order_no) {
	let that = this
	// #ifdef APP-PLUS
	// 我们的项目封装了统一管理API的管理类,请求接口封装每个项目不同,换成自己的方法即可
	this.$api.apiH5Pay({
		'order_no': order_no
	}).then(res => {
		if (res.data.code == 200) {
			let data = res.data.data
			let mweb_url = data.url
			let msg = data.msg
			let confirmText = data.confirm
			uni.showModal({
				title: '提示',
				content: msg,
				confirmText: confirmText,
				showCancel: false,
				success: function (res) {
					if (res.confirm) {
						console.log('用户点击已完成支付');
						// 此处自行编写相应的业务逻辑代码,如订单状态查询或刷新用户信息等
					}
				}
			});			// app创建webview访问服务端返回的h5支付链接
			const platform = uni.getSystemInfoSync().platform
			// 申请h5支付的域名,换成自己的
			const domain = 'www.xxx.com'
			// 创建一个webview
			const webview = plus.webview.create('', 'https://' + domain);
			// 通过webview打开链接,后面加referer表示该链接是从哪里打开的,请填写申请h5支付的域名,比如:http://www.baidu.com,需要已备案
			switch (platform) {
				case 'android':
					webview.loadURL(mweb_url, {'Referer': 'https://' + domain});
					break;
				case 'ios':
					webview.loadURL(mweb_url, {'Referer': domain + '://'});
					break;
				default:
					break;
			}
		}
	}).catch(err => {
		//
	})
	// #endif
},

2.2、 可能遇到的问题

可能会遇到iOS跳转微信完成支付后无法自动返回app,是因为UrlSchemes没有配置好。
解决方案:

点击项目的manifest.json文件, App常用其它设置-UrlSchemes,将申请h5支付的域名输入进去作为返回app的scheme

3、后端部分

3.1 支付接口

// app微信h5支付接口
public function h5Pay() {
		// 订单号
        $order_no = request()->param("order_no");
        // 我设计接口时,做了统一控制,需要登录的接口会自动识别token是否有效,有效则会提前token中的userId。各位可以用各自的方案获取下单的用户信息
        $userModel = User::get($this->userId);
        $orderModel = Order::get(['order_no' => $order_no]);
        if (empty($userModel) || empty($orderModel)) {
            return RApi::error("没有找到订单");
        }
        // 值得一提:如果校验工具通过,却提示签名错误,前往商户平台重新设置一下商户支付密钥就可以了,即使设置一模一样的商户支付密钥也可以,微信的bug
        $timeStamp  =   time();
        $nonceStr   =  Self::createNoncestr();
        $signType = 'MD5';
        $outTradeNo = $order_no;
        $body = $orderModel->body;//描述
        $total_fee = $orderModel->total_fee * 100;
        $openid = $userModel->app_openid;
        
        //统一下单接口
        $result = $this->unifiedorder($openid, $outTradeNo, $nonceStr, $total_fee, $body, 'MWEB');
        // 前端主要用到mweb_url进行支付, app访问5支付链接时,会自动跳转微信app进行支付操作,这个时候比较友好的做法是,在我们的app购买商品页面,弹出一个提示,这里的示例,msg是提示的内容,confirm是提示框按钮文本,后端控制文案,会更灵活,当你遇到变脸很快的产品和老板时,他们突然要改个提示,总不能重新发一个提审包吧
        return RApi::success([
            'url' => $result['mweb_url'],
            'msg' => '请前往微信完成付款',
            'confirm' => '我已完成支付'
            ]);
}

3.2 微信订单支付状态查询

public function orderquery() {
        $order_no = request()->param("order_no");
        $userModel = User::get($this->userId);
        $orderModel = Order::get(['order_no' => $order_no]);
        if (empty($orderModel)) {
            return RApi::error("没有找到订单:" . $order_no);
        }
        
        $appid = ''; // 微信开放平台创建的移动应用appid
    	$mch_id = ''; // 商户号
        
        $transaction_id = $orderModel->transaction_id;//微信订单号
        if (empty($transaction_id)) {
            return RApi::error('微信订单号为空', 201, []);
        }
        
        // 当前时间
        $time = time();
        // 生成随机字符串
        $nonce_str = md5($time . mt_rand(00000,99999));
        //API参数
        $params = [
            'appid' => $appid, //应用ID
            'mch_id' => $mch_id, //商户号
            'transaction_id' => $transaction_id, //商户订单号
            'nonce_str' => $nonce_str, // 随机字符串
        ];
        //请求API
        $url = 'https://baitexiaoyuan.oss-cn-zhangjiakou.aliyuncs.com/updatecrm/php/20231102/orderquery& class="token punctuation">;
        //生成签名
        $params['sign'] = $this->getSign($params);        $xmlData =  $this->arrayToXml($params);        $result  =  $this->xmlToArray($this->postXmlCurl($xmlData, $url, 60));
        // 请求失败
        if ($result['return_code'] === 'FAIL') {
            return RApi::error('查询失败', 201, $result);
        }
        
        // 微信返回的订单状态是已完成支付
        if ($result['return_code'] === 'SUCCESS'||$result['result_code'] === 'SUCCESS'||$result['trade_state'] === 'SUCCESS') {
            // 查询到订单状态的时候,如果已经完成付款,数据库表订单状态却没改变,则进行商品发放并标记已支付
            if($orderModel->state!=1) {
            	// 假如数据库状态为未支付,此处添加业务代码完成支付标记操作
            }
            return RApi::success(1, '支付已完成');
        }
        
        // 查询到了,但是订单状态为未完成支付
        return RApi::success(0, '等待支付');
}

3.3 其余部分相关代码块

// 统一下单接口
private function unifiedorder($openid, $out_trade_no, $noncestr, $total_fee, $body = '' , $trade_type = 'JSAPI') {
    	$appid = ''; // 微信开放平台创建的移动应用appid
    	$mch_id = ''; // 商户号
    	$notify_url = 'https://www.xxx.com/pay/wxNotify'; // 改成自己的回调地址
        $url = 'https://baitexiaoyuan.oss-cn-zhangjiakou.aliyuncs.com/updatecrm/php/20231102/unifiedorder& class="token punctuation">;
        $parameters = array(
            'appid' => $appid,  // 应用id
            'mch_id' => $mch_id,         // 商户号
            'body' => $body,    // 商品描述
            'nonce_str' => $noncestr,             // 随机字符串
            'notify_url' => $notify_url,      // 通知地址 确保外网能正常访问
            'openid' => $openid,                          // 用户微信openid
            'out_trade_no'=> $out_trade_no, // 商户订单号
            'spbill_create_ip' => $this->get_client_ip(),      // 终端IP
            'total_fee' => $total_fee,  // 单位 分
            'trade_type' => $trade_type // 交易类型
        );
        //统一下单签名
        $parameters['sign'] = $this->getSign($parameters);        $xmlData =  $this->arrayToXml($parameters);        $result  =  $this->xmlToArray($this->postXmlCurl($xmlData, $url, 60));
        //$return  =  $this->postXmlCurl($xmlData, $url, 60);
        if (!isset($result['prepay_id']) || empty($result['prepay_id'])) {
           // 统一下单失败
           return false
        }
        return $result;
}// 生成签名
private function getSign($Obj) {
        foreach ($Obj as $k => $v) {
            $Parameters[$k] = $v;
        }
        //签名步骤一:按字典序排序参数
        ksort($Parameters);
        $String = $this->formatBizQueryParaMap($Parameters, false);
        //签名步骤二:在string后加入KEY
        $String = $String . "&key=" . $this->mch_key;
        //签名步骤三:MD5加密
        $String = md5($String);
        //签名步骤四:所有字符转为大写
        $result_ = strtoupper($String);
        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;
}// 数组转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;
}// xml转数组
private function xmlToArray($xml) {
        //禁止引用外部 xml 实体
        libxml_disable_entity_loader(true);
        $xmlstring = simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA);
        $val = json_decode(json_encode($xmlstring), true);
        return $val;
}// xml提交post请求
private static function postXmlCurl($xml, $url, $second = 30)
    {
        $ch = curl_init();
        //设置超时
        curl_setopt($ch, CURLOPT_TIMEOUT, $second);
        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_setopt($ch, CURLOPT_CONNECTTIMEOUT, 20);
        curl_setopt($ch, CURLOPT_TIMEOUT, 40);
        set_time_limit(0);
        //运行 curl
        $data = curl_exec($ch);
        //返回结果
        if ($data) {
            curl_close($ch);
            return $data;
        } else {
            $error = curl_errno($ch);
            curl_close($ch);
            throw new WxPayException("curl 出错,错误码:$error");
        }
}// 生成随机字符串
public static 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;
}

点赞(0) 打赏

评论列表 共有 0 条评论

暂无评论

微信小程序

微信扫一扫体验

立即
投稿

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部