Vue3问题:如何实现微信扫码支付?全面!

前端功能问题系列文章,点击上方合集↑

序言

大家好,我是大澈!

本文约2000+字,整篇阅读大约需要5分钟。

本文主要内容分三部分,第一部分是需求分析,第二部分是实现步骤,第三部分是问题详解。

如果您只需要解决问题,请阅读第一、二部分即可。

如果您有更多时间,进一步学习问题相关知识点,请阅读至第三部分。

1. 需求分析

点击微信扫码支付按钮,会弹出扫码支付弹框,在弹框中部显示一个微信支付的二维码。

用户打开微信扫码并支付成功后,就会关闭弹框,弹出成功消息提示,并刷新表格数据,更新对应订单的支付状态,置灰微信扫码支付按钮。

用户点击弹框内的取消按钮,就会隐藏弹框。

7303fd1b9276e9e9e03aa2ed64cdfa97.png

2. 实现步骤

2.1 准备工作(了解即可)

  • 登录微信公众平台,获取微信公众号开发者ID(AppID)

    70b5488f203f830a3f10a0b8472b0b20.png

  • 登录微信支付商户平台,申请Api证书、设置APIv3秘钥。当然,这里有一个前提,必须要有商家的营业证书,否则无法认证和申请。

    63056be834c3ca0b839c0aa7ce2920c3.png

  • 获取微信支付商户号、获取商户证书序列号。

    4fe1a02adbd6a7fa46d138f718ef878a.png

    0855a71f7cd79ca9a2f5aa0ed81eee9a.png

2.2 编写后端接口(了解即可)

  • pom.xml文件中,引入微信支付相关依赖。

665913fc1352cea091d05289a12875b4.png

  • application.xml文件中,配置上面在准备工作中获取的微信支付相关配置信息。

ab1bbd81346868dc2ffb54e6baae3e5e.png

  • 新建一个微信支付配置类WechatConfig,映射配置文件中配置的参数。

    f1730ddfb2636e7b47ea56843911e76c.png

  • 编写一个微信支付下单请求参数WxOrderDTO类。

    具体参数详情见官方文档:https://pay.weixin.qq.com/docs/merchant/apis/native-payment/direct-jsons/native-prepay.html

  • 编写一个微信返回通知结果集WxResultDTO类。

    具体参数详情见官方文档:https://pay.weixin.qq.com/docs/merchant/apis/native-payment/payment-notice.html

  • 编写一个微信支付工具类WxPayUtils,在其中定义一个获取HttpClient实例的公共方法getClient,通过商户号和序列号,以及加载秘钥文件和证书文件,生成对应的HttpClient实例。

    35bf4f7d894d5523a967d4d1f8f2556a.png

  • 编写调用微信支付接口的WxPayService业务类,在其中编写一个Native支付的统一下单方法CreateNativeOrder

    cc895a5ad381ae1be1cbf1fd0ec6991e.png

  • 编写一个微信支付的WxPayController类,在其中编写一个微信支付下单的方法nativeWxPay

    值得注意的是,请求参数WxOrderDTO中的notify_url参数对应的地址,就是微信支付返回通知的回调地址。

    19382e2687956b129fe3423feb9acf85.png

  • 编写一个带条件分页查询订单列表的接口,用来查询对应订单的支付状态。

    这个比较简单,按个人业务需求编写,此处不再赘述。

cb2ef25d3c977caabaa5b0e9086b48d7.png

  • 编写一个微信支付返回通知回调方法wxCallBack,在这里对微信返回的通知信息进行了签名验证、参数解密,判断通知数据中交易状态为成功后,修改订单状态。

    8c5e674250ab498af2781042a4d09814.pngdd855656f53f09b855fba0e77a4e4ad2.png

  • 扩展:申请微信退款功能实现详细,基本类同微信支付下单流程,此处不再赘述。

    退款参数详情见官方文档:https://pay.weixin.qq.com/docs/merchant/apis/native-payment/create.html

2.3 编写前端

在真实项目中,前端对于微信扫码支付所做的操作并不多。

无非就是调用后端微信扫码支付下单的接口,请求成功后在页面渲染微信支付二维码。

当用户完成支付操作后,利用定时器轮循查询订单支付状态,从而判断当用户支付成功时,刷新数据并重新渲染页面。

详细实现步骤如下:

  • 编写扫码支付二维码弹框。

<template>
  <!-- 扫码支付二维码弹框 -->
  <div>
    <div style="text-align: center;">
      <!-- 使用了Qrcode库来生成二维码,此处不再赘述 -->
      <qrcode
        :text="form.urlCode"
        :width="300"
        :logo="require('@/assets/img/logo.png')"
      />
    </div>
    <div>
      <el-button @click="close">取消</el-button>
    </div>
  </div>
</template>
  • 在API文件中定义2个接口。

// 查询订单支付状态
export const getDetApi = ({ params }: PropsData): any => {
  return fetch({ url:  `/pay/${params.id}`, method: 'get', params })
}

// 微信扫码支付下单接口
export const nativeWxPayApi = ({ params }: PropsData): any => {
  return fetch({ url: `/pay/nativeWxPay/${params.id}`, method: 'get' })
}
  • 编写微信扫码支付方法,在点击微信扫码支付按钮时调用。

// 微信扫码支付
async function getNativeWxPayOrder() {
  if (props.info) {
    // 当前订单的id
    const id = (props.info as any).id

    try {
      // 调用微信扫码支付下单接口
      const res = await nativeWxPayApi({
        params: {
          id: id
        }
      })

      if (res) {
        // 渲染后端返回的微信支付二维码
        form['urlCode'] = res.result.code_url
        // 刷新订单状态
        await getOrderStatus()
      }
    } catch (e) {
      console.log(e)
    }
  }
  • 编写查询订单支付状态方法,在调用微信扫码支付接口完成后调用。

// 获取订单支付状态
const getOrderStatus = async() => {
  const id = (props.info as any).id
  const params = {
    params: {
      id: id
    }
  }

  // 使用定时器循环请求查询订单支付状态接口,直到返回支付成功为止
  const myStateInterval = setInterval(async () => {
    // 调用查询订单支付状态接口
    const res = await getDetApi(params)

    if (res.status === 200) {
      // 如果订单支付状态显示为已支付
      if (res.result['status'] === 1) {
        // 清除定时器
        clearInterval(myStateInterval)
        // 消息通知
        emit('success', '成功')
        // 关闭弹框,刷新数据
        close()
      }
    }
  }, 3000)
}

3. 问题详解

3.1 后端接口代码编写细节

后端微信支付下单和申请退款接口详细,请参考视频教程:https://www.bilibili.com/video/BV1eb4y187Qy?p=18&spm_id_from=pageDriver&vd_source=2571ea6a1d02797fe7590325786e2e84

一切版权归原作者所有,如有侵权请联系删除。

3.2 用到文档地址整理

  • 微信支付API文档:https://pay.weixin.qq.com/docs/merchant/apis/native-payment/direct-jsons/native-prepay.html

  • 微信商户平台:https://pay.weixin.qq.com/

  • 微信公众平台:https://mp.weixin.qq.com

结语

建立这个平台的初衷:

  • 打造一个仅包含前端问题的问答平台,让大家高效搜索处理同样问题。

  • 通过不断积累问题,一起练习逻辑思维,并顺便学习相关的知识点。

  • 遇到难题,遇到有共鸣的问题,一起讨论,一起沉淀,一起成长。

感谢关注微信公众号:“程序员大澈”,然后加入问答群,让我们一起解决实现所有BUG!

猜你喜欢

转载自blog.csdn.net/Ed7zgeE9X/article/details/134486100