---
slug: "wechatpay-skills"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/wechatpay-apiv3/wechatpay-skills@main/README.md"
repo: "https://github.com/wechatpay-apiv3/wechatpay-skills"
source_file: "README.md"
branch: "main"
---
## 微信支付 Skills

微信支付为 AI Agent 提供了专业的技能包（Skills），将产品的业务知识、代码示例和接入规范以 Agent 可理解的方式组织，使 Agent 能够准确地协助开发者完成微信支付的接入工作。

`wechatpay-payment-integration` 是微信支付接入的统一入口 Skill，适用于所有微信支付产品的接入场景，提供以下四大能力：

- **产品选型** — 根据用户业务场景匹配并推荐合适的微信支付产品，并说明选型理由
- **示例代码** — 根据用户索要的接口和开发语言，给出官方示例代码和接口文档 URL，复制即可运行
- **接入质量评估** — 以金融支付专家视角扫描用户接入代码，覆盖安全合规、资金链路及业务常见质量问题，按 🔴🟡🟠 分级输出问题清单和修复方向
- **答疑与排障** — 解答接入中遇到的各类问题，根据错误码或问题现象定位原因并给出解决方案

下面具体说明每块能力。

### 1. 产品选型

**能解决什么问题**：当开发者明确要接入某个微信支付产品后，帮你在该产品内部的多种方案中根据具体业务场景匹配合适的方案，并给出选型理由。

**举个例子**：
- "我做的是公众号点餐，应该用 JSAPI 还是 H5 支付？"
- "我们是 PC 端网站收银，该选 Native 还是 H5？"
- "线下门店扫码付款，用付款码支付还是 Native 支付？"

### 2. 示例代码

**能解决什么问题**：当开发者要把一个完整业务流程跑通（比如下单 → 支付 → 回调 → 退款），按业务流程维度给出端到端可运行的官方代码示例（curl / Java / Go），把签名生成、证书加载、回调验签、敏感字段加解密都包含在内，参数使用真实字段名，复制即可运行。

**举个例子**：
- "给我一份 JSAPI 下单 + 前端调起 + 回调验签的完整代码（Java / Go 都行）"
- "商品券创建批次 → 发券 → 核销 → 退券，串起来给一份示例"
- "退款回调里的 `req_info` 怎么解密，给段代码"

### 3. 接入质量评估

**能解决什么问题**：当开发者准备上线，担心代码里有隐患时，以金融支付专家视角扫描项目里的支付相关代码，逐项检查签名算法、回调验签、敏感字段加密、幂等控制、必接接口（如对账、退款查询）等关键项，按 🔴🟡🟠 分级输出问题清单（哪里有问题、为什么是问题、参考的官方规范、修复方向），帮助开发者在上线前发现并修复隐患。

**举个例子**：
- "上线前帮我扫一下整个支付模块，看有没有隐患"
- "我这段回调处理代码有没有问题？"
- "检查下我的签名生成代码是不是规范"
- "我接的JSAPI支付有没有漏掉必接接口？"

### 4. 答疑与排障

**能解决什么问题**：解答开发者在接入过程中遇到的各类问题——知识查询、流程说明、接口规则咨询、字段含义、错误码释义等；当开发者调用接口报错或行为异常时，根据提供的错误码、错误信息、请求/响应报文定位原因并给出解决方案。

**举个例子**：
- "支付回调如果一直返回失败，微信会重试几次？间隔多久？"
- "微信支付平台证书和 API 证书有什么区别？"

## 交流与反馈

欢迎填写问卷，帮助我们持续改进：🔗 [问卷链接](https://wj.qq.com/s2/26981880/3d9d/)

在使用过程中遇到问题、有改进建议，或者想和其他开发者交流接入经验，欢迎扫码加入 **微信支付 Skills 交流群**，与官方团队和社区开发者一起讨论：


<img width="375" height="375" alt="wecom-temp-163912-2c4af5449820ab21d77a688cae86249f" src="https://github.com/user-attachments/assets/4503e74c-7e4d-4064-86c5-d8e4b6928827" />
