# wechatpay-skills

**Repository Path**: uptopia/wechatpay-skills

## Basic Information

- **Project Name**: wechatpay-skills
- **Description**: No description available
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 微信支付 Skills

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

### Skills 列表

| Skill | 说明 |
| --- | --- |
| [wechatpay-payment-integration](./wechatpay-payment-integration/SKILL.md) | 微信支付全产品接入指引 |
| [wechatpay-product-coupon](./wechatpay-product-coupon/SKILL.md) | 微信支付商品券接入 |

💡 **推荐使用 `wechatpay-payment-integration`**：这是微信支付接入的统一入口 Skill，支持产品选型、示例代码、接入质量评估、答疑与排障四大能力，适用于所有微信支付产品的接入场景。

如需接入**商品券**产品，建议使用专属的 `wechatpay-product-coupon` Skill，其中包含商品券完整的业务知识和代码示例。

### 四大能力

每个 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" />