@wechatpay-apiv3/wechatpay-medical-insurance-payment

微信支付 Skills

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

每个 Skill 对应一个微信支付产品，提供以下五大能力：

• 产品选型 — 根据业务场景推荐合适的产品方案，并说明选型理由
• 示例代码 — 按业务流程输出官方代码示例，签名、证书、回调验签等细节都写好，复制即可运行
• 知识问答 — 接入流程、参数说明、状态流转、回调机制、错误码含义等业务知识问答
• 质量检测 — 扫描项目代码，按上线 checklist 逐项检查签名、回调、必接接口等关键项，输出问题清单
• 排障 — 根据错误码和报文给出可能原因和排查步骤，快速定位问题

下面具体说明每块能力。

1. 产品选型

能解决什么问题：当开发者明确要接入某个微信支付产品后，帮你在该产品内部的多种方案中（比如基础支付里的 JSAPI / APP / H5 / Native / 小程序 / 付款码等）根据具体业务场景匹配合适的方案，并给出选型理由。

举个例子：

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

2. 示例代码

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

举个例子：

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

3. 知识问答

能解决什么问题：当开发者在接入过程中遇到细节问题（某个参数什么意思、订单状态有几种、回调会重试几次、证书多久过期等），基于结构化整理的业务知识（接入流程、参数说明、状态机、回调规则、限流规则、证书机制、错误码含义等）给出准确回答，并附上对应的官方文档链接以便深入查阅。

举个例子：

• "支付分的订单从创建到完结一共有几种状态，怎么流转？"
• "分账接口里 unfreeze_unsplit 这个参数什么意思？什么时候该传 true？"
• "支付回调如果一直返回失败，微信会重试几次？间隔多久？"
• "微信支付平台证书和 API 证书有什么区别？"

4. 质量检测

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

举个例子：

• "上线前帮我扫一下整个支付模块，看有没有隐患"
• "我这段回调处理代码有没有问题？"
• "检查下我的签名生成、证书加载是不是规范"
• "我接的商品券有没有漏掉必接接口？"

5. 排障

能解决什么问题：当开发者调用接口报错或行为异常时，根据提供的错误码、错误信息、请求/响应报文，结合该产品的常见错误模式，给出可能的原因列表和对应的排查步骤、修复建议，帮助开发者快速定位问题。

举个例子：

• "下单接口返回 SIGN_ERROR，请求体我贴一下，帮我看下哪里签错了"
• "回调一直收不到通知，可能是哪些原因？怎么定位？"
• "调用退款返回 NOTENOUGH，可是我账户明明有钱"
• "证书验签报 Invalid signature，怎么排查？"

交流与反馈

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

<img width="400" height="653" alt="537861b0940fbaf56cf6e7f2d0ab3207" src="https://github.com/user-attachments/assets/8cefe131-866b-49c5-bf11-ae4c6b600652" />