首页 > 编程语言 >从前端的角度来梳理微信支付(小程序、H5、JSAPI)的流程

从前端的角度来梳理微信支付(小程序、H5、JSAPI)的流程

时间:2023-11-28 09:47:21浏览次数:44  
标签:orderId code 微信 JSAPI H5 获取 支付 wx

因业务需要,开发微信支付功能,涉及三种支付方式:

  • JSAPI 支付:微信内网页支付,需要开通微信服务号
  • 小程序支付:在小程序中支付,需要开通小程序
  • H5 支付:在手机浏览器(出微信内网爷)中网页支付

使用微信支付的前提必开通微信商户号,要使用到那种的支付方式要前需在商户平台开通(要审核)。

支付的钱最终都会到商户号里(一般由公司财务开通)。

开发微信支付的过程中大大小小坑还是踩了不少,终于做完了,整理下开发流程。

参考:

小程序支付

开发流程

  1. 小程序端请求创建订单接口,后端统一下单获取 orderId 并返回
  2. 小程序端获取通过wx.login()获取code
  3. 小程序端拿这codeorderId请求后端接口,获取支付所需数据
  4. 获取支付所需数据之后,小程序端调用wx.requestPayment()接口,直接调用起支付页面
  5. 判断是否支付成功后的逻辑

伪代码

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("支付失败");
  }
}

注意事项

  1. 申请微信小程序账号 申请成功可拿到 AppID(小程序 id)和 AppSecret(小程序密钥) 申请类型为企业性质,否则无法接入微信支付
  2. 微信小程序认证 通过认证的小程序才能接入微信支付和绑定商户平台
  3. 申请商户平台账号 需要第一步申请的 AppID 申请成功可拿到 MchID(商户 id)和 MchKey(商户密钥)
  4. 信小程序关联商户号 微信和商户都认证成功后,在微信后台微信支付菜单中进行关联
  5. 接入微信支付 在微信后台微信支付菜单中进行接入

参考

H5 支付

开发流程

  1. 前端端请求创建订单接口,后端统一下单获取 orderId 并返回
  2. 前端带着 orderId 请求支付接口,获得 mweb_url
  3. 然后跳转 mweb_url 会跳转微信自动调用微信支付
  4. 支付后返回支付页,判断是否支付成功(需发送请求后端查询) 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 支付不能直接在微信客户端内调起,请在外部浏览器调起。

参考

JSAPI 支付(微信内网页支付)

开发流程

  • 商品页
  1. 前端商品页创建订单,在后端统一下单后获取 orderId
  2. 前端带着 orderId 跳转到支付页,
  • 支付页
  1. 获取 code
    1. 第一次进入页面,判断是否路径中有 code
    2. 没有 code,请求数据跳转授权页面,code 会通过回调地址一起返回回来
    3. 拿到 code,发送给后端,后端解析到 openid,保存好。
  2. 点击确定支付按钮,触发 wxPay() 方法
    1. 发送 orderId 给后端,获取 wxData
    2. wxData 中包含 wx.configwx.chooseWXPay 两个接口的数据。
    3. 先调用 wx.config()然后在调用 wx.chooseWXPay(),如果一切正常,支付页面就会弹出。
  3. 支付状态通过后端去查询

伪代码

  • 商品页
// 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 页面,到根目录即可,也就是#号之前的地址)

  • 开通微信公众号(服务号) - 设置安全域名、设置授权域名

  • 收集参数:appId 和 AppSecret

  • 添加 Web 开发工具开发者(需要开发者同时开发者关注开发的微信公众号和微信公众账号安全助手)参考文档

  • 设置回调域名(例如:www.xx.com/pay,最后获取的 code 会拼在此回调地址后返回,返回后如www.xx.com/pay?code=xxxx参考 1

  • 获取 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

  • 获取 wx.config 的参数 [站外图片上传中...(image-6f3528-1605777597831)]

  • 获取 wx.chooseWXPay 所需的参数 [站外图片上传中...(image-692237-1605777597831)]

参考

总结

整个流程走下来,体验是:小程序支付最方面(因为配置少),其次是 H5,JSAPI 支付最麻烦(文章一多半都在写它)

在微信支付功能开发过程中,其实最麻烦的不是开发流程,而是他的各种配置和授权流程,为了拿到所需的参数而来回折腾。

开发过程中的一些参数是经常用到的,如 appid、openid、orderId

支付流程大径相同,先获取到用户的 openid,知道你是谁,然后统一下单拿到 orderId 再去处理不同平台的支付方式

标签:orderId,code,微信,JSAPI,H5,获取,支付,wx
From: https://www.cnblogs.com/wp-leonard/p/17861140.html

相关文章

  • 线上微信小程序无法登录问题
    反馈客户反馈无法线上小程序无法登录复现因为本地有为微信开发者工具,所以本地很快复现,找到traceid,查询sls日志,发现有问题日志:###Errorupdatingdatabase.Cause:com.mysql.cj.jdbc.exceptions.CommunicationsException:Communications linkfailure日志指向数据库通讯有......
  • 微信文章附件
    微附件是一个专业的文件图床服务平台,其主要目的是为微信公众号提供文件附件的添加和管理功能。由于微信公众号原生的功能中并不直接支持附件的上传和分享,微附件因此成为了一个极其重要的补充工具,发挥着重要的传媒功能。1、首先要知道如何打开微附件:利用下方图片,在浏览器中打开。其......
  • 微信的标签管理,怎样标签群发更高效?
    ......
  • 微信机器人接口开发
    请求URL:http://域名地址/sendHeadImage请求方式:POST请求头Headers:Content-Type:application/jsonAuthorization:Authorization值(登录获取群码信息接口中返回的认证信息值)参数:参数名必选类型说明wId是string登录实例标识path是string图片url链接返回数据:参数名类型说明codestring1000......
  • 微信公众号文章附件
    微附件是一个专业的文件图床服务平台,其主要目的是为微信公众号提供文件附件的添加和管理功能。由于微信公众号原生的功能中并不直接支持附件的上传和分享,微附件因此成为了一个极其重要的补充工具,发挥着重要的传媒功能。1、首先要知道如何打开微附件的官网:利用下方图片中的网址,在......
  • uniapp微信小程序微信同声传译和OCR支持功能
    1.首先小程序后台设置里面的第三方设置插件管理需要添加微信同声传译和OCR支持两个插件2.【微信同声传译】在manifest.json切换成源码视图然后在appid同级目录添加插件/*小程序特有相关*/"mp-weixin":{"appid":"wx9fd66d4d0e83c5f9","setting"......
  • 关于微信小程序中如何实现数据可视化-echarts动态渲染
    移动端设备中,难免会涉及到数据的可视化展示、数据统计等等,本篇主要讲解原生微信小程序中嵌入echarts并进行动态渲染,实现数据可视化功能。基础使用首先在GitHub上下载echarts包地址:https://github.com/ecomfe/echarts-for-weixin/tree/master下载项目解压压缩包,将ec-canvas文......
  • unapp(微信小程序)-跳转页面之后返回原页面保留原页面数据
    1.第一步:跳转至新页面1uni.navigateTo({2url:`/pages-tracerecord/hn-contact?add=${encodeURIComponent(JSON.stringify(3{4ID:this.operate.ClientID,5SiteID:this.operate.ShareID,6Source:"Tradings"7}))}`8});2.第二步:返回之......
  • 个人微信机器人接口
    请求URL:http://域名地址/sendText请求方式:POST请求头Headers:Content-Type:application/jsonAuthorization:login接口返回参数:参数名必选类型说明wId是string登录实例标识wcId是string接收人微信id/群idcontent是string文本内容消息返回数据:......
  • 微信小游戏开发怎么选游戏引擎
    微信小游戏现在非常的火,当我们下定决心做微信小游戏开发的时候,面临我们的第一个问题是怎么选一个H5的游戏引擎,那么今天本小编就来给大家分析一下目前能开发各大平台H5小游戏的游戏引擎和它们的优缺点。入选原则:(1)能一次开发,同时发布到多个游戏平台的游戏引擎;(android,IOS,......