3-3 小程序支付开发准备工作（API密钥、API证书配置）
学习策略建议
API 密钥、API 证书、APIv3 密钥这三个概念在实际开发中非常容易混淆。建议的策略是：结合具体使用场景学习，碰到接口文档中涉及密钥的说明时再去深入理解。
小程序支付 API
前端小程序支付核心 API：
wx.requestPayment-- 常用，本课程重点wx.requestOrderPayment-- 类似，了解即可
接入前准备（5 步）
按照微信官方文档的接入前准备步骤：
| 步骤 | 内容 | 状态 |
|---|---|---|
| 1 | 申请 APPID | 已有小程序即可获得 |
| 2 | 申请 MCHID（商户号） | 注册商户平台后获得 |
| 3 | 绑定 APPID 和 MCHID | 小程序后台或商户平台均可操作 |
| 4 | 配置 APIv3 密钥 | 商户平台 > 账户中心 > API 安全 |
| 5 | 下载并配置商户证书 | 使用证书申请工具 |
步骤四：配置 APIv3 密钥
- 登录微信商户平台
- 进入"账户中心 > API 安全"
- 点击"设置密钥"
- 使用密码生成器生成 32 位随机密钥
密钥生成工具推荐：
| 工具 | 说明 |
|---|---|
| 1Password | 内置密码生成器，可设置长度、字符类型 |
| LastPass | 在线密码生成器 |
| Bitwarden | 开源免费密码管理器 |
- 粘贴密钥，输入操作密码 + 手机短信验证码
- 设置成功
步骤五：下载并配置商户证书
- 商户平台 > API 安全 > 申请证书
- 下载证书申请工具（支持 Windows 和 macOS）
- 选择证书存储路径
- 复制商户信息（商户号 + 商户名称）到工具中
- 输入操作密码 + 手机验证码
- 复制生成的证书串回到网页
- 证书生成完成
生成的证书文件包含：
cert/
├── apiclient_cert.pem # 商户证书公钥
├── apiclient_key.pem # 商户证书私钥
└── apiclient_cert.p12 # PKCS12 格式证书
text
小程序与商户号关联
在小程序后台"功能 > 微信支付"中：
- 有商户号：直接关联
- 无商户号：申请接入
- 主体一致：直接确认绑定
- 主体不一致：需要平台审核
准备工作总结流程
选择直连模式（非服务商模式）
└── 企业主体认证小程序
└── 配置 APIv3 密钥
└── 下载商户证书
└── 商户号与小程序关联
└── 准备完成 ✓
text
易混概念回顾
| 概念 | 对应接口版本 | 用途 |
|---|---|---|
| API 密钥 | V2 | 旧版接口签名 |
| APIv3 密钥 | V3 | 请求服务器证书、解密回调数据 |
| 商户证书 | V2 + V3 | 证明商户身份，退款等高权限操作 |
参考资源
↑