

虚拟支付前置开通流程建议看官方就够了~

https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/virtual-payment/person.html

> 温馨提示：
> - 本文从服务端接入开始陈述
> - 仅限小程序是非云开发
> - 后端语言基于 Java，重要代码会给出

---

## 一、配置消息推送

### 1. 启用消息推送

在小程序后台「开发管理 → 消息推送」中启用。
启用后，用户发给小程序的消息以及开发者需要的事件推送，都会被微信转发到配置的服务器地址。

### 2. 配置消息推送

- 服务器地址：最好是没有任何校验、没有任何参数的公网可访问地址
- Token：自己生成 32 位，保存到自己的服务器
- EncodingAESKey：随机生成，保存到自己的服务器
- 消息加密方式：推荐使用 **安全模式**
- 数据格式：推荐使用 **JSON**

### 3. 保存消息推送

提交后，服务器配置完成，数据格式配置会在 5 分钟内生效。

---

## 二、Java 实现：接收消息推送验签（GET 请求）

消息推送配置验证接口是 **GET 请求**，返回字符串而不是 JSON。

```java
/**
 * @Description 微信消息推送服务器配置接口
 * @return org.springframework.http.ResponseEntity<java.lang.Object>
 * @Author 小帅丶
 * @Date 2026年9月24日
 */
@GetMapping(value = "/message/{code}")
public String configMsg(
        @RequestParam(name = "signature", required = false) String signature,
        @RequestParam(name = "timestamp", required = false) String timestamp,
        @RequestParam(name = "nonce", required = false) String nonce,
        @RequestParam(name = "echostr", required = false) String echostr,
        @PathVariable(name = "code", required = false) String code) {

    log.info("方法路径{}", requestURI);
    String token = CommonConstant.VirtualWXPayConts.PUSH_TOKEN;

    startTime = System.currentTimeMillis();
    param = StrUtil.nullToEmpty(request.getQueryString());
    log.info("微信消息推送URL验证-参数:{} code:{}", param, code);

    boolean checkResult = WXMsgPushUtil.checkSignature(token, timestamp, nonce, signature);
    log.info("微信消息推送URL验证-验签结果:{}", checkResult);

    timeConsuming = String.valueOf(System.currentTimeMillis() - startTime);
    log.info("耗时{}", timeConsuming);

    // 验签失败返回 fail，让后台配置提示失败
    String beanStr = checkResult ? StrUtil.nullToEmpty(echostr) : "fail";
    log.info("微信消息推送URL验证-返回结果:{}", beanStr);

    return beanStr;
}
```

---

## 三、虚拟支付：代币充值

### 1. 准备工作

- 虚拟支付相关 id 信息自己保存
- 本文只做「代币充值」实现
- 需要结合业务系统创建必要表和业务代码

代币配置示例：

- 代币名称：独立开发者的一点燃料
- 兑换比例：
  - 1 人民币 = 1 代币
  - 1 人民币 = 10 代币
  - 1 人民币 = 100 代币

如果是 1:100，充值 1 元，购买数量就是 100。

---

### 2. 预下单：创建订单

```java
/**
 * @Description 虚拟支付预下单
 * @Author 小帅丶
 * @Date 2022年6月16日 14:53:35
 */
@RequestMapping(value = "/order", method = RequestMethod.POST)
public ResponseEntity<Object> order(
        @RequestBody(required = false) VPayOrderRequest vPayRequest) {

    log.info("方法路径{}", requestURI);
    VPayOrderResponse bean = new VPayOrderResponse();

    try {
        startTime = System.currentTimeMillis();

        if (ObjectUtil.isEmpty(vPayRequest)
                || StrUtil.isEmpty(vPayRequest.getPayCode())
                || ObjectUtil.isEmpty(vPayRequest.getBuyQuantity())
                || ObjectUtil.isEmpty(vPayRequest.getEnv())
                || ObjectUtil.isEmpty(vPayRequest.getSessionKey())
                || ObjectUtil.isEmpty(vPayRequest.getUserId())
                || ObjectUtil.isEmpty(vPayRequest.getOpenid())
                || ObjectUtil.isEmpty(vPayRequest.getProductCode())) {
            bean.error("下单参数为空");
        } else {
            bean = virtualPayComponent.createVPayOrder(vPayRequest);
        }
    } catch (Exception e) {
        errorMsg = e.getMessage();
        log.info("虚拟支付下单错误出错了" + errorMsg);
        bean.error("下单错误");
    }

    timeConsuming = String.valueOf(System.currentTimeMillis() - startTime);
    log.info("耗时{}", timeConsuming);

    beanStr = JSON.toJSONString(bean);
    apiBeanUtil.putLog(...);

    return new ResponseEntity<>(beanStr, httpHeaders, HttpStatus.OK);
}
```

---

### 3. 小程序调起支付

```js
requestVirtualPayment(order) {
  wx.requestVirtualPayment({
    signData: order.signData,
    paySig: order.paySig,
    signature: order.signature,
    mode: order.mode,
    success(res) {
      console.log('requestVirtualPayment success', res)
    },
    fail({ errMsg, errCode }) {
      console.error(errMsg, errCode)
      wx.showModal({
        title: '支付失败',
        content: errMsg + '（错误码：' + errCode + '）',
        showCancel: false,
        confirmText: '知道了'
      })
    }
  })
}
```

---

## 四、支付成功：接收消息推送并发货（POST 请求）

```java
@PostMapping(value = "/message/{code}")
public ResponseEntity<Object> pushMsg(
        @RequestBody(required = false) String body,
        @RequestParam(name = "signature", required = false) String signature,
        @RequestParam(name = "timestamp", required = false) String timestamp,
        @RequestParam(name = "nonce", required = false) String nonce,
        @RequestParam(name = "openid", required = false) String openid,
        @RequestParam(name = "encrypt_type", required = false) String encrypt_type,
        @RequestParam(name = "msg_signature", required = false) String msg_signature,
        @PathVariable(name = "code", required = false) String code) {

    WXPushMsgResponse pushMsgResponse = new WXPushMsgResponse();
    log.info("方法路径{}", requestURI);
    startTime = System.currentTimeMillis();

    // 1. 先落库
    PayVirtualNotify payVirtualNotify = new PayVirtualNotify();
    payVirtualNotify.setCode(code)
            .setSignature(signature)
            .setTimestamp(timestamp)
            .setNonce(nonce)
            .setOpenid(openid)
            .setEncryptType(encrypt_type)
            .setMsgSignature(msg_signature)
            .setMsgBody(body)
            .setCreateBy("wechat")
            .setCreateTime(new Date());
    payVirtualNotifyService.save(payVirtualNotify);

    String token = CommonConstant.VirtualWXPayConts.PUSH_TOKEN;
    String encodingAesKey = CommonConstant.VirtualWXPayConts.PUSH_ENCODING_AES_KEY;
    String appId = code;

    boolean aesMode = WXMsgPushUtil.ENCRYPT_TYPE_AES.equalsIgnoreCase(encrypt_type);
    String encrypt = aesMode ? WXMsgPushUtil.getEncrypt(body) : null;

    boolean checkResult = aesMode
            ? WXMsgPushUtil.checkMsgSignature(token, timestamp, nonce, encrypt, msg_signature)
            : WXMsgPushUtil.checkSignature(token, timestamp, nonce, signature);

    if (!checkResult) {
        pushMsgResponse.setErrCode("1");
        pushMsgResponse.setErrMsg("fail");
    } else {
        try {
            String plainMsg = aesMode
                    ? WXMsgPushUtil.decrypt(encrypt, encodingAesKey, appId)
                    : body;

            WXPushVirtualPayResponse msgJson =
                    JSON.parseObject(plainMsg, WXPushVirtualPayResponse.class);

            String event = msgJson.getEvent();

            if (CommonConstant.VirtualWXPayConts.EVENT_PAY_NOTIFY.equals(event)) {
                virtualPayComponent.handlePayNotify(msgJson);
            }

            if (CommonConstant.VirtualWXPayConts.EVENT_PAY_REFUND.equals(event)) {
                // 处理退款通知
            }

            pushMsgResponse.setErrCode("0");
            pushMsgResponse.setErrMsg("success");
        } catch (Exception e) {
            errorMsg = e.getMessage();
            pushMsgResponse.setErrCode("1");
            pushMsgResponse.setErrMsg("fail");
        }
    }

    String beanStr;
    if (aesMode) {
        beanStr = WXMsgPushUtil.buildJsonReply(
                JSON.toJSONString(pushMsgResponse),
                token, encodingAesKey, appId, nonce);
    } else {
        beanStr = JSON.toJSONString(pushMsgResponse);
    }

    return new ResponseEntity<>(beanStr, httpHeaders, HttpStatus.OK);
}
```

---

## 五、业务系统需要做的改动

1. 创建「订单表」「商品 / 道具表」
2. 小程序端增加充值、购买、余额展示功能
3. 通过微信消息推送接收「支付成功 / 退款」事件
4. 支付成功后：更新订单状态 + 增加用户代币余额
5. 必须有兜底能力：
   - 支付状态查询
   - 退款接口

---

> 总结：个人主体小程序做虚拟支付，核心是「消息推送配置 → 预下单 → 小程序调起支付 → 微信回调处理 → 业务侧加币」，Token / AESKey 自己存，安全模式用 `msg_signature`，回包要加密 JSON。


示例代码:https://gitcode.com/u010651369/codes
扫码体验:
![下载 (1).png](https://developer.qcloudimg.com/http-save/yehe-1219395/9ec04825ad445d3338e630655b28847d.jpg)

https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/virtual-payment/person.html

【个人学习】【虚拟支付】一个人、一个小工具、一次合规收款：我的虚拟支付接入全流程

这篇个人开发者笔记记录了非云开发、Java 后端小程序接入微信虚拟支付的实操流程：先配置消息推送（公网 URL、Token、EncodingAESKey、安全模式+JSON），用 GET 接口完成验签回 echostr；再做代币充值，服务端接收下单参数并创建虚拟支付订单，小程序用 wx.requestVirtualPayment 调起支付；支付/退款结果通过微信 POST 消息推送到达，服务端验签

后端

开发工具

虚拟支付开通需以官方文档为准，本文详解Java服务端接入流程：先配置消息推送并完成GET验签，再实现预下单与小程序调起支付，最后通过POST回调处理支付成功事件。重点涵盖Token与AESKey管理、安全模式加解密、订单及代币余额更新等核心步骤，附完整代码示例。

代码解释

服务器

JSON

Java

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【个人学习】【虚拟支付】一个人、一个小工具、一次合规收款：我的虚拟支付接入全流程-腾讯云开发者社区-腾讯云

【个人学习】【虚拟支付】一个人、一个小工具、一次合规收款：我的虚拟支付接入全流程

【个人学习】【虚拟支付】一个人、一个小工具、一次合规收款：我的虚拟支付接入全流程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐