JeecgBoot低代码平台微信支付宝支付模块集成开发指南

JeecgBoot AI专题研究 | JeecgBoot低代码支付功能前端对接实战


支付集成的整体架构

在 JeecgBoot低代码平台中,支付功能采用前后端分离的标准架构:前端负责发起支付请求、展示支付界面(二维码或跳转),后端负责与微信/支付宝的服务器通信、处理回调通知、维护订单状态。

本文聚焦于前端侧的对接实现,涵盖微信扫码支付和支付宝网页支付两种主流方式。

微信支付:扫码支付流程

微信支付采用"生成付款码 → 用户扫码 → 轮询结果"的标准流程。

1. 获取支付二维码

调用 JeecgBoot低代码后端接口获取微信支付二维码:

  • 接口地址 :/pay/getPayCode
  • 请求参数 :buyYears --- 订阅时长,可选值为 1、2、3

接口返回支付二维码图片和关联的订单信息。前端将二维码渲染到页面上,引导用户使用微信扫码完成支付。

2. 轮询支付状态

用户扫码后,前端需要持续查询支付结果:

  • 接口地址 :/pay/queryPayStatus
  • 请求参数:订单号(从获取二维码时的响应中获取)
  • 轮询策略:建议每 2~3 秒查询一次,设置合理的超时上限(如 5 分钟)

查询结果有三种状态:

  • 支付成功 --- 跳转到成功页面,更新用户权益
  • 支付失败 --- 提示用户重新发起支付
  • 等待支付 --- 继续轮询
支付宝支付:表单提交流程

支付宝支付的前端实现与微信有所不同,采用的是"获取表单 → 新窗口提交"的方式。

1. 获取支付表单

  • 接口地址 :/pay/alipay/getAlipayVipForm
  • 请求参数:与微信支付类似的订阅信息

接口返回的是一段 HTML 表单代码,包含了提交到支付宝服务器所需的全部参数。

2. 表单提交实现

前端需要动态创建 DOM 元素,将返回的表单 HTML 注入其中,并在新窗口中触发提交:

typescript 复制代码
const handleAlipay = (formData: string) => {
  const div = document.createElement('div');
  div.innerHTML = formData;
  document.body.appendChild(div);
  const form = div.querySelector('form');
  if (form) {
    form.target = '_blank';
    form.submit();
  }
  document.body.removeChild(div);
};

表单提交后,用户会被重定向到支付宝的收银台页面完成支付。

前端组件设计建议

在 JeecgBoot低代码平台的 Vue3 + TypeScript 技术栈下,支付组件的设计可以参考以下结构:

复制代码
PaymentPanel/
├── index.vue          # 主容器:套餐选择 + 支付方式切换
├── WechatPay.vue      # 微信支付:二维码展示 + 状态轮询
├── AlipayPay.vue      # 支付宝支付:表单提交逻辑
└── usePayment.ts      # 组合式函数:封装支付相关 API 调用

套餐选择交互:使用 Radio 组件让用户选择订阅时长,确保选中状态与支付请求参数联动。

支付方式切换:Tab 或 Radio 切换微信/支付宝,切换时重置支付状态。

安全与异常处理
  • 订单防重复:同一用户在上一笔订单未完成时,不应允许发起新的支付请求
  • 轮询超时:设置最大轮询次数或时间上限,超时后提示用户刷新或重试
  • 表单清理:支付宝表单提交后,及时从 DOM 中移除动态创建的元素
  • 金额校验:前端展示金额应与后端返回一致,前端不做金额计算

总结

JeecgBoot低代码平台的支付模块封装了微信和支付宝两种主流支付方式的对接逻辑,前端开发者只需调用约定的 API 接口即可完成集成。微信支付侧重二维码展示和状态轮询,支付宝侧重表单动态提交,两者的差异决定了不同的前端实现策略。


本文为 JeecgBoot AI 专题研究系列文章。

相关推荐
她的男孩7 小时前
设计器能拖抄送,一点发布却报 flowable-servicetask-invalid-type:Forge Admin 部署前改写节点属性
spring boot·低代码·工作流引擎
用户86194177207412 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
wechatbot8882 天前
企业微信外部群聊自动回复机器人开发实战
微信·机器人·企业微信·企业微信scrm·企业微信二次开发·企业微信api
极客互动API2 天前
企业微信外部联系人消息群发控制台效果展示
微信·企业微信·企微scrm·企业微信api·企微外部联系人
她的男孩3 天前
审批人选了「部门主管」,发起却报 Unknown property:Forge Admin 启动时补齐组织变量
spring boot·低代码·工作流引擎
Eyfcom4 天前
〖物流低代码实战 03〗物流中台的服务编排与协议转换:从“点对点调用”到“可视化编排”
低代码·快递系统·物流低代码实战
ClouGence4 天前
自动化测试定位不到元素怎么办?
selenium·低代码·测试
Java小卷4 天前
面向 Schema 编程,Vue 3 页面级渲染引擎!强大的第三方 UI 适配与扩展(一)
vue.js·低代码
技术分享官4 天前
Geejing WebBuilder 新手指导:用 Wb.Button 按钮组件跑通企业级快速开发平台的前后端闭环
前端·javascript·低代码
她的男孩4 天前
转办给同事后对方一点同意就报幂等冲突:Forge Admin 不把转办键当成终态
spring boot·低代码·工作流引擎