莱莱 发表于 2024-6-19 22:28:11

必看!前端角度梳理微信付出(小步伐、H5、JSAPI)流程解密

因业务须要,开辟微信付出功能,涉及三种付出方式:


[*]JSAPI 付出:微信内网页付出,须要开通微信服务号
[*]小步伐付出:在小步伐中付出,须要开通小步伐
[*]H5 付出:在手机浏览器(出微信内网爷)中网页付出
使用微信付出的前提必开通微信商户号,要使用到那种的付出方式要前需在商户平台开通(要考核)。
付出的钱终极都会到商户号里(一样平常由公司财政开通)。
开辟微信付出的过程中大大小小坑还是踩了不少,终于做完了,整理下开辟流程。
参考:


[*]微信付出-接入指引
[*]微信付出-开辟文档
小步伐付出

开辟流程


[*]小步伐端请求创建订单接口,后端统一下单获取 orderId 并返回
[*]小步伐端获取通过wx.login()获取code
[*]小步伐端拿这code和orderId请求后端接口,获取付出所需数据
[*]获取付出所需数据之后,小步伐端调用wx.requestPayment()接口,直接调用起付出页面
[*]判定是否付出成功后的逻辑
伪代码

async function wxPay(goodId) {
// 1. 创建订单 获取orderId
let orderId = await ajax("POST", "/api/OrderProgram/CreateTheOrder", {
    goodId, // 商品id
});
// 2. 获得 code
let code = await wxlogin(); // 基于pr封装的wx.login()方法
// 3. 获取支付的数据
let payData = await ajax("POST", "/api/OrderProgram/WxXcxPay", {
    orderId,
    code,
});
// 4. 发起支付
let res = await payment(payData); // 基于pr封装的wx.requestPayment()方法
// 5. 判断是否支付成功
let payResult = res.errMsg;
if (payResult == "requestPayment:ok") {
    console.log("支付成功");
} else if (payResult == "requestPayment:fail cancel") {
    console.log("用户取消支付");
} else {
    console.log("支付失败");
}
}
留意事项


[*]申请微信小步伐账号
申请成功可拿到 AppID(小步伐 id)和 AppSecret(小步伐密钥)
申请类型为企业性子,否则无法接入微信付出
[*]微信小步伐认证
通过认证的小步伐才气接入微信付出和绑定商户平台
[*]申请商户平台账号
须要第一步申请的 AppID
申请成功可拿到 MchID(商户 id)和 MchKey(商户密钥)
[*]信小步伐关联商户号
微信和商户都认证成功后,在微信后台微信付出菜单中进行关联
[*]接入微信付出
在微信后台微信付出菜单中进行接入
参考



[*]小步伐付出文档
[*]小步伐开辟文档
H5 付出

开辟流程


[*]前端端请求创建订单接口,后端统一下单获取 orderId 并返回
[*]前端带着 orderId 请求付出接口,获得 mweb_url,
[*]然后跳转 mweb_url 会跳转微信自动调用微信付出
[*]付出后返回付出页,判定是否付出成功(需发送请求后端查询)
4.1 革新页面,获取最新的付出(订单)状态。
4.2 设置一个的按钮"我已付出",让用户点击自动查询状态。
伪代码

async function wxH5Pay(goodId) {
// 1. 创建订单 获取orderId
let orderId = await ajax("POST", "/api/OrderProgram/CreateTheOrder", {
    goodId, // 商品id
});
// 2. 获取支付跳转的URL
let mweb_url = await ajax("POST", "/api/OrderProgram/WxH5Pay", { orderId });
// 3. 跳转URL去微信支付
if (mweb_url) {
    location.href = mweb_url;
} else {
    console.log("回调地址出错");
}
// 4. 支付后返回支付页,判断是否支付成功
// 4.1 刷新页面,获取最新的订单(商品)状态。
// 4.2 设置一个"我已支付"的按钮,让用户点击之后查询状态。
}
留意事项



[*]在商户平台设置正确的付出域名
[*]调试须要在线上,假如嫌麻烦可以使用内网穿透(Ngrok 或花生壳)
[*]需对redirect_url进行urlencode处置惩罚
[*]H5 付出不能直接在微信客户端内调起,请在外部浏览器调起。
参考



[*]微信付出-H5 付出-开辟步骤
JSAPI 付出(微信内网页付出)

开辟流程



[*]商品页

[*]前端商品页创建订单,在后端统一下单后获取 orderId
[*]前端带着 orderId 跳转到付出页,


[*]付出页

[*]获取 code
[*]第一次进入页面,判定是否路径中有 code
[*]没有 code,请求数据跳转授权页面,code 会通过回调地址一起返回返来
[*]拿到 code,发送给后端,后端解析到 openid,生存好。

[*]点击确定付出按钮,触发 wxPay() 方法
[*]发送 orderId 给后端,获取 wxData
[*]wxData 中包含 wx.config 和 wx.chooseWXPay 两个接口的数据。
[*]先调用 wx.config()然后在调用 wx.chooseWXPay(),假如一切正常,付出页面就会弹出。

[*]付出状态通事后端去查询
伪代码



[*]商品页
// 1. 创建订单 获取orderId
let orderId = await ajax("POST", "/api/OrderProgram/CreateTheOrder", {
goodId, // 商品id
});
// 2. 携带id 跳转到支付页
this.$router.push({ name: "wx_pay_page", params: { orderId: id } });


[*]入口文件(main.js)
// main.js 引入 js-sdk
import wx from "weixin-js-sdk";


[*]付出页 HTML
<template>
<div>
    <button @click="wxPay">点击支付</button>
</div>
</template>
付出页 JS
// Vue
data(){
    return {
      orderId: this.$route.params.orderId, // 订单id
      url: '',// 获取code的url
      wxData: null,// js-sdk接口所需的数据
    }
},
mounted(){
    // 判断是否有code
    this.getCode()
}
methods: {
    getCode() {
      var code = this.getUrlPram("code");
      if (code != null) {
            this.code = code;
            // 拿到 code 发给 后端
            this.sendCode(code);
      } else {
            // 去拿code
            this.getUrl();
      }
    },
    getUrl() {
      // 请求后端拿到url所需数据,然后跳转页面在通过回调地址返回,获取code.
      this.axios
            .post("/api/OrderProgram/GetOpenidAndAccessToken", {
                orderId: this.orderId,
            })
            .then((data) => {
                this.url = `https://open.weixin.qq.com/connect/oauth2/authorize?appid=${data.appId}&redirect_uri=${data.redirect_uri}&response_type=${data.response_type}&scope=${data.scope}&state=${data.state}`;
                window.location.href = this.url;
            })
            .catch((err) => {
                console.log(err);
            });
    },
    sendCode(code) {
      // 发送code给后端 后端解析出openid
      this.axios
            .post("/api/OrderProgram/GetOpenidAndAccessTokenFromCode", {
                code: code,
            })
            .then((res) => {
                console.log(res);
            })
            .catch((err) => {
                console.log(err);
            });
    },
    wxPay: async function() {
      // 发送orderid,获取wx.chooseWXPay和wx.config所需的参数
      this.wxData = await this.axios.post(
            "/api/OrderProgram/WxJSAPIPay",
            { orderId: this.orderId }
      );
      let wxConfigData = this.wxData.wxConfigData // 获取wx.chooseWXPay()所需数据
      let wxPayData = this.wxData.wxPayData;// 获取wx.config()所需数据
      this.$wx.config({
            debug: false, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
            appId: wxConfigData.appId, // 必填,公众号的唯一标识
            timestamp: wxConfigData.timeStamp, // 必填,生成签名的时间戳
            nonceStr: wxConfigData.nonceStr, // 必填,生成签名的随机串
            signature: wxConfigData.paySign, // 必填,签名
            jsApiList: [
                "chooseWXPay",
            ],
      });
      // 执行支付
      this.$wx.chooseWXPay({
            timestamp: wxPayData.timeStamp, // 支付签名时间戳,注意微信jssdk中的所有使用timestamp字段均为小写。但最新版的支付后台生成签名使用的timeStamp字段名需大写其中的S字符
            nonceStr: wxPayData.nonceStr, // 支付签名随机串,不长于 32 位
            package: wxPayData.package, // 统一支付接口返回的prepay_id参数值,提交格式如:prepay_id=\*\*\*)
            signType: wxPayData.signType, // 签名方式,默认为'SHA1',使用新版支付需传入'MD5'
            paySign: wxPayData.paySign, // 支付签名
            success: (res) => {
                this.$toast("支付成功");
            },
            fail: (err) => {
                this.$toast("支付失败");
            },
      });
    },
}
同时支持 H5 付出和 JSAPI 付出

// 在创建订单之后,就判断环境使用哪种方法支付。
if (isWx()) {
this.WXPay(orderId); // 带着orderId跳转到支付页逻辑
} else {
this.H5Pay(orderId); // 执行上面H5支付中的创建订单之后的逻辑
}
// 判断是否是微信浏览器
function isWx() {
let uAgent = navigator.userAgent.toLowerCase();
reutrn(/micromessenger/.test(uAgent)) ? true : false;
}
留意事项



[*] 开通微信商户号 - 设置付出目录(假如是 Vue 这类 SPA 页面,到根目录即可,也就是#号之前的地址)
https://img-blog.csdnimg.cn/img_convert/2878e322b7907aa210452323f0466f66.png
[*] 开通微信公众号(服务号) - 设置安全域名、设置授权域名
https://img-blog.csdnimg.cn/img_convert/7f7d4f58bf9c27086e6cd1c21218a4b5.png
[*] 收集参数:appId 和 AppSecret
[*] 添加 Web 开辟工具开辟者(须要开辟者同时开辟者关注开辟的微信公众号和微信公众账号安全助手)参考文档
https://img-blog.csdnimg.cn/img_convert/f0a52ec65d939f9ac5c863e3d668ea65.png


[*] 设置回调域名(例如:www.xx.com/pay,最后获取的 code 会拼在此回调地址后返回,返回后如www.xx.com/pay?code=xxxx)参考 1
https://img-blog.csdnimg.cn/img_convert/1993f7bb9ab2d4a29e69a008b25092b3.png
[*] 获取 code

[*] 参考获取 code 文档
[*] 在微信客户端网页打开授权地址,跳转之后,在返回的回调地址之后拿到 code:

https://open.weixin.qq.com/connect/oauth2/authorize
?appid=你的appid
&redirect_uri=你的回调地址(拿到code后返回)
&response_type=code(返回类型,默认code)
&scope=snsapi_base(授权范围,静默授权拿到openid)
&state=STATE(自定义状态,非必填)
#wechat_redirect(重定向使用必须携带)
redirect_uri参数要和你在微信公众号里设置的回调域名一致(例如:www.xx.com/pay),须要留意的是这 url 须要urlEncode。
请求这个地址之后,code 会以你设置的redirect_uri地址里的参数带返来,拿到之后传给后端就行了。


[*] 前端引入 js-skd

[*]使用script引入js-sdk
[*]下载使用 npm 包weixin-js-sdk

[*] 获取 wx.config 的参数
https://img-blog.csdnimg.cn/img_convert/99fb6793ee59081e83e9c700fa9a3c85.png
[*] 获取 wx.chooseWXPay 所需的参数
https://img-blog.csdnimg.cn/img_convert/8c042601bff89ad1fc0c600493245235.png
参考



[*]微信付出-JSAPI
[*]微信公众号-网页授权
[*]JS-SDK 开辟文档
[*]小步伐、H5 登录授权、分享、付出流程
[*]wx.config 接口注入时signature参数须要留意,坑比力多
[*]我的 JS-SDK 使用总结
总结

整个流程走下来,给我的体验是:小步伐付出最方便(因为配置少),其次是 H5,JSAPI 付出最麻烦(文章一多半都在写它)
在微信付出功能开辟过程中,其实最麻烦的不是开辟流程,而是他的各种配置和授权流程,为了拿到所需的参数而来回折腾。
开辟过程中的一些参数是经常用到的,如 appid、openid、orderId
付出流程大径相同,先获取到用户的 openid,知道你是谁,然后统一下单拿到 orderId 再行止理不同平台的付出方式
开辟时候用到的相关文档,一定要仔细阅读二遍以上为止!!
遇到问题不要死刚,多百度多 Google,说禁绝你遇到的问题已经有无数的人遇到过并且已经有成熟的解决方案了。
前端和后端要多沟通,有什么问题(难点)随时反馈,须要什么参数好好说,遇到观点不一致的时候万万要留意控制住情绪,切莫撕逼(.——.)。
因为本人水平有限,对后端流程懂得不多,只能从前端的角度来梳理整个付出流程。
以上,盼望对你有所帮助。
欢迎关注,微信公众号:九旬
https://img-blog.csdnimg.cn/img_convert/d4f61faa1f33db547e2b858b3f6bbb23.png

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页: [1]
查看完整版本: 必看!前端角度梳理微信付出(小步伐、H5、JSAPI)流程解密