微信支付 APIv3 Postman 脚本安装和配置指南

1. 项目基础介绍和主要编程语言

项目基础介绍

微信支付 APIv3 Postman 脚本是一个用于调试微信支付 APIv3 的工具。它通过 Postman 的前置脚本（Pre-Request Script）功能，帮助开发者快速构造并发送微信支付 APIv3 请求。该项目旨在简化微信支付 API 的调试流程，使开发者能够更高效地进行开发和测试。

主要编程语言

该项目主要使用 JavaScript 编写，特别是 Postman 的前置脚本部分。JavaScript 是一种广泛应用于前端和后端开发的编程语言，具有良好的灵活性和强大的生态系统。

2. 项目使用的关键技术和框架

关键技术

• Postman: 一款业界知名的 API 构建和使用平台，支持通过脚本扩展功能。
• Forge: 一个用于处理加密和解密操作的 JavaScript 库，用于生成和验证签名。
• SM2: 腾讯国密库 TencentSM-javascript 的 SM2 签名算法，用于支持国密签名。

框架

该项目没有使用传统的框架，而是直接利用 Postman 的脚本功能和一些开源的 JavaScript 库来实现功能。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

1. 注册 Postman 账户: 建议注册一个 Postman 账户，以便使用其各种功能，包括云同步和团队协作。
2. 获取微信支付商户 API 证书: 商户需要申请商户 API 证书，并生成商户私钥，保存在本地证书文件夹的文件 apiclient_key.pem 中。

详细安装步骤

步骤 1: Fork 方式导入脚本

1. 访问项目仓库: 打开 GitHub 项目链接。
2. Fork 项目: 点击页面右上角的 Fork 按钮，将项目 Fork 到自己的 GitHub 账户。
3. 导入到 Postman:
   • 打开 Postman 应用。
   • 点击左上角的 Import 按钮。
   • 选择 Link 选项卡，输入 Fork 后的项目链接，点击 Continue。
   • 在弹出的窗口中，选择 Fork Collection，填入标签 Fork Label，并选择目的工作台 Workspace（通常选择 My Workspace）。
   • 点击 Fork Collection 完成导入。

步骤 2: 配置 Environment

1. 创建环境:
   • 在 Postman 中，点击右上角的 Environment 下拉菜单，选择 Manage Environments。
   • 点击 Add 按钮，创建一个新的环境，命名为 WeChatPay APIv3。
2. 添加变量:
   • 在新建的环境中，点击 Add a new variable，添加以下变量：
     • mchid: 商户号（必填）
     • merchant_serial_no: 商户 API 证书序列号（必填）
     • apiclient_key.pem: PEM 格式的商户 API 私钥（必填）
   • 将 apiclient_key.pem 的变量类型设置为 secret，以确保私钥的安全性。

步骤 3: 发送请求

1. 选择请求:
   • 在 Postman 中，进入 WeChatPay APIv3 集合，选择你要发送的请求。
2. 配置请求参数:
   • 根据请求的注释，填入请求参数，修改 Body 中的参数。
3. 选择环境:
   • 在右上角的环境下拉菜单中，选择刚刚配置的 WeChatPay APIv3 环境。
4. 发送请求:
   • 点击地址栏右侧的 Send 按钮，发送请求。

注意事项

• 安全: 商户 API 私钥是非常敏感的信息，请确保将配置了私钥的工作台（workspace）的可见性设置为私有 Personal 或者 Private。
• 同步更新: 项目会逐步添加新接口和更新已有接口，建议关注项目的 Public Workspace，以便及时获取更新。

通过以上步骤，你就可以成功安装和配置微信支付 APIv3 Postman 脚本，并开始使用它进行开发和测试。