一、概述
如果需要实现微信支付功能,需要有一个已认证的微信服务号,并且开通微信支付,开通后微信会提供一个商户ID。有了这个ID才能成功调用微信支付接口。
开通微信支付后,需要在微信支付后台【产品中心】=>【开发配置】中配置【JSAPI支付授权目录】和【Native支付回调链接】,如下图所示:
微信支付可以分为两种情况,微信浏览器之外的扫码支付(需要配置Native支付回调链接,支付完成后,微信服务器会调用这个链接,并传入参数。)和微信浏览器之内直接支付(需要配置JSAPI支付授权目录,只有这个域名下的链接才能调用支付接口)。两种支付都需要调用【统一下单接口】。所以本节针对统一下单接口来分别讲解如何实现这两种支付方法。
一、统一下单接口
通过调用下面的统一下单接口,就可以实现微信支付功能。
代码语言:javascript复制https://api.mch.weixin.qq.com/pay/unifiedorder
统一下单接口需要传入的参数包括如下内容(以下为必填项),并且参数要为xml格式:
- appid:公众号id
- body:商品描述
- mch_id:商户号id
- nonce_str:随机字符串
- notify_url:异步接收微信支付结果通知的回调地址,通知url必须为外网可访问的url,不能携带参数。
- openid:用户标识
- out_trade_no:商户订单号
- spbill_create_ip:终端IP
- total_fee:订单总金额,单位为分
- trade_type:交易类型JSAPI 、NATIVE、APP
- sign:签名
获取签名的规则与之前JS-SDK的签名规则相同,字段除了上述1-10十个字段外,还需要添加一个微信商户后台获取的key(【账户中心】=》【API安全】获取)
二、统一下单接口的返回值
交易类型为【JSAPI】
返回的xml格式会包含一个prepay_id。然后将这个值传递给前端,再由前端调用jsapi完成支付,示例代码如下所示:
代码语言:javascript复制 1 document.querySelector(".pay").onclick = function(){
2 function onBridgeReady() {
3 WeixinJSBridge.invoke(
4 'getBrandWCPayRequest', {
5 "appId": `{{appId}}`, //公众号名称,由商户传入
6 "timeStamp": `{{timeStamp}}`, //时间戳,自1970年以来的秒数
7 "nonceStr": `{{nonceStr}}`, //随机串
8 "package": `{{package}}`,
9 "signType": `{{signType}}`, //微信签名方式:
10 "paySign": `{{paySign}}` //微信签名
11 },
12 function (res) {
13 if (res.err_msg == "get_brand_wcpay_request:ok") {
14 // 使用以上方式判断前端返回,微信团队郑重提示:
15 //res.err_msg将在用户支付成功后返回ok,但并不保证它绝对可靠。
16 kk="/success"
17 }
18 });
19 }
20 if (typeof WeixinJSBridge == "undefined") {
21 if (document.addEventListener) {
22 document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false);
23 } else if (document.attachEvent) {
24 document.attachEvent('WeixinJSBridgeReady', onBridgeReady);
25 document.attachEvent('onWeixinJSBridgeReady', onBridgeReady);
26 }
27 } else {
28 onBridgeReady();
29 }
30 }
交易类型为【NATIVE】
返回的结果包括一个code_url字段,将这个字段的值传递给前端,然后转换成二维码,用户扫码即刻完成支付。
三、完成支付
完成支付后,微信服务器会向notify_url的参数地址发送一个支付结果的消息。网站或公众号程序可以根据返回结果,自行处理支付完成后的业务逻辑。