原文地址:http://cloud.yundashi168.com/archives/732#i-6
场景概述
鉴于去年做过微信app支付,小程序支付,支付宝app支付,云闪付app支付等方面的功能和研究。最近要完成一个在微信公众号支付的场景。其中遇到了一个坑,坑了我足足一上午多的时间。所以我想写下来记录,以后遇到微信相关API调用的时候,就不会花这么久的时间了。
技术场景:微信公众号支付
本文不会详细讲解微信公众号支付的具体流程,因为官网文档已经说得很详细,至少比我写的详细。而且本文的目的是记录我自己遇到的坑,而不是写支付教程。放心,下次有时间多的话,我会手把手的写下相关教程步骤的。
技术概况
开发前的准备工作
微信公众号服务号+微信支付商户号(都是需要企业资格)
备案的域名一个
-
后端支付程序部署测试:
1:本地服务+花生壳端口映射的方式(我采用的方案)
2:购买云服务器和购买域名并且通过备案微信公众号需要是服务号认证,需要开通微信支付功能,这些都需要交钱 300大洋一年。这里就不多讲了,如果开通服务号,商户号,网上资料很多。
我选择花生壳的目的是:第一:本地调式程序速度快,虽然本人拥有很多台阿里云的服务器,而且我也熟悉后端程序发布,但是我还是选择在开发测试阶段,先用花生壳本地端口映射。第二:花生壳提供的域名是经过备案的,做做测试用还是可以的。
看见没,花生壳端口映射的域名,支持外网80端口(只能提供一个80端口)和外网随机端口。内网主机的端口,你自定义定义。是不是非常方便和适合测试微信,支付宝,云闪付之类的开发测试呢?
开发阶段
因为本人需要自己搞定移动前端网页和后端支付接口,所以前端我采用我熟悉的技术栈React来开发,后端采用的是SpringBoot框架来开发。
后端接口程序
核心代码:微信公众号后端支付接口
接口URL: http://qq784602719.imwork.net/school/wxpay/webPay
请求参数:需要传入openId(微信公众号身份标识)和total_fee(支付金额)
/**
* 公众号支付
*/
@RequestMapping(value ="/webPay",method = {RequestMethod.POST,RequestMethod.GET})
@ResponseBody
public AjaxResult webPay(
HttpServletRequest request,
HttpServletResponse response,
@RequestParam("total_fee")
String total_fee,@RequestParam("openId")
String openId) {
// openId,采用 网页授权获取 access_token API:SnsAccessTokenApi获取
//String openId = (String) request.getSession().getAttribute("openId");
System.out.println("openId:"+openId);
System.out.println("total_fee:"+total_fee);
if (StrKit.isBlank(openId)) {
result.addError("openId is null");
return result;
}
if (StrKit.isBlank(total_fee)) {
result.addError("请输入数字金额");
return result;
}
String ip = IpKit.getRealIp(request);
System.out.println("ip:"+ip);
if (StrKit.isBlank(ip)) {
ip = "127.0.0.1";
}
System.out.println("AppId:"+WxPayApiConfigKit.getWxPayApiConfig().getAppId());
System.out.println("MchId:"+WxPayApiConfigKit.getWxPayApiConfig().getMchId());
System.out.println("PaternerKey:"+WxPayApiConfigKit.getWxPayApiConfig().getPaternerKey());
System.out.println("notify_url:"+notify_url);
Map params = WxPayApiConfigKit.getWxPayApiConfig()
.setAttach("微信公众号支付测试 -By arison")
.setBody("微信公众号支付测试 -By arison")
.setOpenId(openId)
.setSpbillCreateIp(ip)
.setTotalFee(total_fee)
.setTradeType(TradeType.JSAPI)
.setNotifyUrl(notify_url)
.setOutTradeNo(String.valueOf(System.currentTimeMillis()))
.build();
String xmlResult = WxPayApi.pushOrder(false,params);
log.info(xmlResult);
Map resultMap = PaymentKit.xmlToMap(xmlResult);
String return_code = resultMap.get("return_code");
String return_msg = resultMap.get("return_msg");
if (!PaymentKit.codeIsOK(return_code)) {
result.addError(return_msg);
return result;
}
String result_code = resultMap.get("result_code");
if (!PaymentKit.codeIsOK(result_code)) {
result.addError(return_msg);
return result;
}
// 以下字段在return_code 和result_code都为SUCCESS的时候有返回
String prepay_id = resultMap.get("prepay_id");
Map packageParams = PaymentKit.prepayIdCreateSign(prepay_id);
String jsonStr = JSON.toJSONString(packageParams);
result.success(jsonStr);
System.out.println("data:"+jsonStr);
return result;
}
接口方法里面有些参数加密的方法用进行了封装(对微信公众号支付提供的demo中的工具类),在这里代码就不一一展示了。因为并不是很重要。
前端支付程序
这里用的是React技术,网络请求用的是fetchPost。请求的时候,后端需要配合处理下跨域问题。
这里的userOpenid是在前端项目绑定页面中绑定成功之后,把微信公众号给的openId通过Redux传给其它React界面。所以这里通过this.props.userOpenid就拿到了Redux传过来的openId。
wxPayRequest = () => {
Toast.loading("")
// const data="wxpay/webPay"; this.props.userOpenid
fetchPost("http://qq784602719.imwork.net/school/wxpay/webPay", {
openId: this.props.userOpenid,
total_fee: '1'
}).then((response) => {
Toast.hide();
console.log("response:" + JSON.stringify(response));
const data = response.data;
if (typeof WeixinJSBridge == "undefined") {
if (document.addEventListener) {
document.addEventListener('WeixinJSBridgeReady', this.onBridgeReady(data), false);
} else if (document.attachEvent) {
document.attachEvent('WeixinJSBridgeReady', this.onBridgeReady(data));
document.attachEvent('onWeixinJSBridgeReady', this.onBridgeReady(data));
}
} else {
this.onBridgeReady(data);
}
}).catch((error) => {
console.log("error:" + JSON.stringify(error));
})
}
onBridgeReady = (json) => {
const that = this;
WeixinJSBridge.invoke(
'getBrandWCPayRequest', JSON.parse(json),
function (res) {
if (res.err_msg == "get_brand_wcpay_request:ok") {
// 使用以上方式判断前端返回,微信团队郑重提示:
//res.err_msg将在用户支付成功后返回ok,但并不保证它绝对可靠。
Toast.success("支付成功!")
} else {
message.info("支付失败:" + res.err_msg)
that.setState({
payInfo: json,
payResult: "支付失败:" + JSON.stringify(res)
});
}
});
}
当我在前端写的支付界面中调用上面的 wxPayRequest 方法后,遇到了错误 get_brand_wcpay_request:fail
我马上通过JSON.stringify(res)把错误对象解析成字符串放入界面展示,为了看到更全的报错信息。如图:
错误信息:
{"err_desc":"调用支付JSAP缺少参数appId","err_msg":"get_brand_wcpay_request:fail","err_code":"-1"}
我当时就在想,我openId在本地后端程序日志窗口打印发现,我参数传到后端接口方法是对的啊,而且我微信公众号和商户号也设置正确了。尤其是设置了商户平台的 支付授权目录。
支付授权目录是:你的支付界面访问路径
http://qq784602719.imwork.net/school/rechargeHome 去掉最后一个斜杠后面的字符串
支付授权目录 http://qq784602719.imwork.net/school/
但是我设置了正确的支付授权目录之后,还是提示上面那个问题,缺少参数appId。很是纳闷啊。不过我感觉是前端JS调用方面确实出现了问题,于是开始排查JS端写的代码。
后面经过多次排查,问题果然还是被我找到了,找到之后,发现居然是一个很简单的问题。不过还是最终解决了问题。
问题的关键之处是我出问题的代码写成了如下:
onBridgeReady = (json) => {
const that = this;
WeixinJSBridge.invoke(
'getBrandWCPayRequest', json,
function (res) {
if (res.err_msg == "get_brand_wcpay_request:ok") {
// 使用以上方式判断前端返回,微信团队郑重提示:
//res.err_msg将在用户支付成功后返回ok,但并不保证它绝对可靠。
Toast.success("支付成功!")
} else {
message.info("支付失败:" + res.err_msg)
that.setState({
payInfo: json,
payResult: "支付失败:" + JSON.stringify(res)
});
}
});
}
微信JSAP 接口 WeixinJSBridge.invoke中第二个参数是javascript对象,而不是json字符串!!!后面我用JSON.parse(json)把服务器接口给我的json字符串转化为javascript对象,就能顺利支付成功了。
附属参考文档:
微信公众号支付文档:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6
微信支付提示 调用支付JSAPI缺少参数:appId :https://bbs.csdn.net/topics/391028145
微信支付JSAPI支付授权目录陷阱:https://blog.csdn.net/a7442358/article/details/85766204
解决我错误的启发文章:微信公众号支付JSAPI,提示:2支付缺少参数:appId