# WeChatPayScaffolding

**Repository Path**: yangbuyi/WeChatPayScaffolding

## Basic Information

- **Project Name**: WeChatPayScaffolding
- **Description**: 使用微信官方文档对接微信支付
内置vue3+vite前端使用微信官方原生接口对接native v3 v2，jsapi  v3
内置小程序端 uniapp
示例：使用快速对接神器IJPay对接jsapi  v3
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://lzys522.cn/wx
- **GVP Project**: No

## Statistics

- **Stars**: 20
- **Forks**: 4
- **Created**: 2023-05-21
- **Last Updated**: 2024-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 微信群聊

 **微信公众号搜索 `杨不易呀` 回复加群备注微信支付邀请入群解答** 

# 从零玩转微信支付

### 配套文章

前往语雀,进入我的花园,下拉选择知识库进去找到从零玩转微信支付系列文章教程.

[点我前往我的花园](https://www.yuque.com/troubles)

### 介绍

使用微信官方文档对接微信支付

内置 vue3+vite 前端使用微信官方原生接口对接 native v3 v2

内置小程序端 使用快速对接神器 IJPay 对接 jsapi v3

同步更新： 码云[GITEE](https://gitee.com/yangbuyi/wxDemo) 外国 [GITHUB](https://github.com/yangbuyiya/wxDemo)

### 软件架构

<p> 前端 vue3 + vite + element plus
<p> 小程序 uniapp
<p> 后端 boot 2.x + mybatis plus + mysql

### 安装教程

1. 将商户证书全部复制到**resources**目录下
2. **如果你想使用IJPay则需要** 下载微信平台证书（不是商户证书）


> ☠ 注意：本项目当中有两个案例
> 
> IJPay对比 JSAPI V3 的用法 需要手动下载(微信平台证书)
> 
> 使用com.github.wechatpay-apiv3官方原生依赖里面处理了证书自动同步更新我们不需要配置 可不需要自己手动下载微信平台证书

#### 2.1 Certificate Downloader (微信平台证书)

Certificate Downloader 是 Java 微信支付 APIv3 平台证书的命令行下载工具。

#### 快速开始

该工具已经通过 Maven 打包成
CertificateDownloader.jar，可在 [release ](https://github.com/EliasZzz/CertificateDownloader/releases) 中下载。
下载 jar 包后，如果你没有证书，第一次下载证书的命令如下

```bash
java -jar CertificateDownloader.jar -k ${apiV3key} -m ${mchId} -f ${mchPrivateKeyFilePath} -s ${mchSerialNo} -o ${outputFilePath}

示例：

java -jar CertificateDownloader-1.2.0-jar-with-dependencies.jar
-k=商户v3key
-m=商户ID
-f=/Users/yangbuyi/Documents/workPath/workPath/wx-play-demo/src/main/resources/apiclient_key.pem
-s=商户证书序列号
-o=/Users/yangbuyi/Documents/workPath/workPath/wx-play-demo/src/main/resources

解释：

java -jar CertificateDownloader-1.2.0-jar-with-dependencies.jar
-k=这是对应配置文件当中的 APIV3Key（wxpay.api-v3-key）商户APIV3Key
-m=这是对应配置文件当中的 mchID （wxpay.mch-id） 商户ID
-f=这是对应配置文件当中到 商户证书 apiclient_key.pem  （绝对路径地址）
-s=这是对应配置文件当中的 mchSerialNo（wxpay.mch-serial-no）商户平台证书序列号
-o=这是将生成的文件输出到哪个目录下面 （绝对路径地址）

必需参数有：

- `-f <privateKeyFilePath>`，商户API私钥文件路径
- `-k <apiV3Key>`，证书解密的密钥
- `-m <merchantId>`，商户号
- `-o <outputFilePath>`，保存证书的路径
- `-s <merchantSerialNo>`，商户API证书的序列号
```

![](https://foruda.gitee.com/images/1685674014076230916/f6659409_5151444.png)

### 后端配置

<p> 1.1 前往 wxpay.properties 配置好对应的微信配置</p>
<p> 1.2 前往 application.yml 配置好数据库链接信息

### pc 端配置

<p> 1. vite.config.js 配置你的后端请求url

### uniapp 小程序配置

<p> 1.1 使用 HBuilder软件导入wx-play-uniapp
<p> 1.2 修改后端对应到appId 
<p> 1.3 修改wx-play-uniapp/utils/request.js 请求路径 baseUrl

### 本地支付回调调试

1. 使用内网穿透工具代理后端端口
2. 前段修改对应的 baseUrl

# PC 端演示

[前往](https://lzys522.cn/wx/)

![输入图片说明](https://foruda.gitee.com/images/1685673897693356870/89f3440f_5151444.png)

# uniapp 小程序演示

<img src="https://foruda.gitee.com/images/1685673930068447278/c20a6a06_5151444.png" width="300px" height="450px"   />
<img src="https://foruda.gitee.com/images/1685673948311564004/1354febc_5151444.png" width="300px" height="450px"  />
<img src="https://foruda.gitee.com/images/1685673968161079699/b1465aba_5151444.png" width="300px" height="450px"   />
<img src="https://foruda.gitee.com/images/1685673988191687152/69f3b19b_5151444.png" width="300px" height="450px"   />