微信支付为 AI Agent 提供了专业的技能包（Skills），将产品的业务知识、代码示例和接入规范以 Agent 可理解的方式组织，使 Agent 能够准确地协助开发者完成微信支付的接入工作。
每个 Skill 对应一个微信支付产品，包含：
- 业务知识 — 接入流程、参数说明、状态流转等，结构化整理，Agent 可直接检索
- 代码示例 — 覆盖各接口的 API 调用示例（含签名），Agent 检索后展示，开发者参考即用
- 交互规范 — 定义 Agent 的能力边界和交互流程，确保回答准确可靠
基于以上内容，每个 Skill 覆盖接入过程中的五大场景：
| 场景 | 说明 |
|---|---|
| 产品选型 | 根据业务需求，引导开发者选择合适的产品方案 |
| 示例代码 | 提供各接口的 API 调用示例（含签名），开发者参考即用 |
| 知识问答 | 接入流程、参数说明、状态流转等业务知识，随问随答 |
| 质量检测 | 上线前扫描代码，检查签名、回调、必接接口等常见隐患 |
| 排障 | 根据错误信息定位问题原因，给出排查方案 |
接入微信支付前，需完成以下准备工作。每一步均附有官方文档链接和一步直达操作入口。
微信支付支持两种接入模式，选择不同模式后，后续 API 路径和核心参数不同：
| 模式 | 适用场景 | 入驻平台 |
|---|---|---|
| 商户模式 | 有开发能力的商户，自行收款 | 商户平台 |
| 服务商模式 | 代中小商户接入，资金到子商户账户 | 服务商平台 |
📄 官方文档：mchid 与 appid 申请（含接入模式说明）
根据业务场景选择合适的支付方式：
| 场景 | 推荐支付方式 | 前置要求 |
|---|---|---|
| 公众号内网页支付 | JSAPI 支付 | 已认证服务号 + openid |
| 小程序内支付 | 小程序支付 | 已认证小程序 + openid |
| 原生 APP 内支付 | APP 支付 | 开放平台移动应用 APPID |
| 微信外手机浏览器 | H5 支付 | 企业/事业单位主体（不支持个体工商户） |
| PC 网站扫码付款 | Native 支付 | 无特殊 |
| 线下收银台扫码 | 付款码支付 | 仅 V2 接口 |
📄 官方文档：
申请商户号（mchid）：
| 模式 | 操作入口 |
|---|---|
| 商户模式 | 微信支付接入指引（商户入驻） |
| 服务商模式 | 服务商商户入驻 |
申请 APPID：
| APPID 类型 | 获取入口 |
|---|---|
| 公众号 AppID | 登录 公众平台 → 设置与开发 → 基本配置 → 开发者ID(AppID) |
| 小程序 AppID | 登录 公众平台 → 开发管理 → 开发设置 → AppID |
| 移动应用 AppID | 登录 开放平台 → 管理中心 → 移动应用 → 详情 → APPID |
📄 官方文档：mchid 与 appid 申请
所有支付方式都要求商户号与 APPID 建立绑定关系，未绑定时下单接口会报错。
操作入口：
| 步骤 | 操作路径 |
|---|---|
| 第一步：发起绑定 | 商户平台 → 产品中心 → APPID授权管理 → +关联AppID → 新增授权 |
| 第二步：确认授权 | 对应平台（公众平台/开放平台）→ 微信支付 → 商户号管理 → 待关联商户号 → 确认 |
| 第三步：查看结果 | 商户平台 → 产品中心 → APPID账号管理 → 我关联的APPID账号 |
📄 官方文档：管理商户号绑定的 APPID 账号
⚠️ 一个商户号最多关联 50 个 APPID，绑定后不可解绑。
商户 API 证书用于 APIv3 请求签名和调起支付签名，不可泄露。
操作入口：
- 登录 商户平台 → 账户中心 → 账户设置 → API安全 → 申请证书
- 下载 微信支付证书工具 生成证书请求串
- 提交证书请求串，获取商户 API 私钥（apiclient_key.pem）和证书序列号（certificateSerialNo）
📄 官方文档：商户 API 证书常见问题
APIv3 密钥用于回调通知中 resource 字段的 AES-256-GCM 解密，不参与请求签名。
操作入口：
登录 商户平台 → 账户中心 → 账户设置 → API安全 → 设置APIv3密钥
📄 官方文档：配置 APIv3 密钥
密钥要求：32 个字符，支持数字和大小写字母组合。
微信支付公钥用于验证微信支付响应和回调通知的签名（与平台证书二选一）。
操作入口：
- 登录 商户平台（需超管或安全联系人）→ 账户中心 → API安全
- 点击「微信支付公钥」→「申请公钥」
- 申请成功后点击「下载公钥」，记录公钥 ID（wechatPayPublicKeyId）
📄 官方文档：微信支付公钥产品简介及使用说明
不同支付方式有各自的专属配置项：
| 支付方式 | 专属配置 | 操作入口 |
|---|---|---|
| JSAPI 支付 | 配置 JSAPI 支付授权目录 | 商户平台 → 产品中心 → 开发配置 → JSAPI支付 → 配置授权目录 |
| H5 支付 | 配置 H5 支付域名 | 商户平台 → 产品中心 → 开发配置 → H5支付 → 添加H5支付域名 |
| APP 支付 | 开放平台移动应用 APPID + 包名/签名配置 | APP支付开发指引 |
| 小程序支付 | 小程序 AppID | 无额外配置，确保小程序已认证即可 |
| Native 支付 | 无特殊 | — |
📄 官方文档：
接入前请确认以下参数已收齐：
| 参数 | 说明 | 获取位置 |
|---|---|---|
| mchid | 商户号 | 商户入驻成功后邮件通知 |
| appid | 应用 ID | 公众平台 / 开放平台 |
| 商户 API 证书私钥 | apiclient_key.pem | 商户平台 → API安全 → 申请证书 |
| 商户 API 证书序列号 | certificateSerialNo | 商户平台 → API安全 → 查看证书 |
| 微信支付公钥 ID | wechatPayPublicKeyId | 商户平台 → API安全 → 微信支付公钥 |
| 微信支付公钥文件 | wxp_pub.pem | 商户平台 → API安全 → 下载公钥 |
| APIv3 密钥 | 回调解密用 | 商户平台 → API安全 → 设置APIv3密钥 |
在使用过程中遇到问题、有改进建议，或者想和其他开发者交流接入经验，欢迎扫码加入 微信支付 Skills 交流群，与官方团队和社区开发者一起讨论：
