基础支付接入Skill

更新时间：2026.04.09

一、概述

本 Skill 为接入微信支付基础支付的开发者提供了一站式的智能辅助能力，包括支付方式选型、示例代码检索、业务知识查询、接入质量评估和问题排查。开发者在支持 Skill 的 AI IDE 中打开项目，通过对话即可获得接入过程中的指引与帮助。GitHub仓库地址

引入方式：

Clone 本仓库或下载 Skill 目录，将其放置到你项目中对应 AI IDE 的 Skill 配置目录下。

方式一：命令行加载

在项目根目录下执行以下命令，自动完成 Skill 的下载和配置：

1npx skills add https://github.com/wechatpay-apiv3/wechatpay-skills --yes

方式二：Clone 仓库

直接 Clone 本仓库，用支持 Skill 的 IDE 打开项目即可使用：

1git clone https://github.com/wechatpay-apiv3/wechatpay-skills.git

方式三：手动复制目录

如果你已有项目，将 Skill 目录复制到项目中对应 AI IDE 的 Skill 配置目录下即可。

以 Cursor 为例，将 Skill 目录复制到项目根目录的 .cursor/skills/ 下：

1your-project/
2└── .cursor/
3    └── skills/
4        └── wechatpay-basic-payment/
5            ├── SKILL.md
6            └── references/

不同 AI IDE 的 Skill 配置目录可能不同，请参考对应 IDE 的文档。

验证是否生效：

打开 AI IDE 对话，输入"我要接入基础支付"。如果 Skill 已生效，助手会主动询问你的接入模式（商户模式还是服务商模式），而不是给出泛泛的回答。

不确定该用哪种支付方式时，描述你的业务场景，Skill 会从客户端环境（App / 微信内 / 浏览器 / PC）、支付体验（拉起收银台 / 扫码 / 付款码）、是否涉及多商户合单等维度进行匹配，覆盖 JSAPI、APP、H5、Native、小程序、付款码及合单支付。

示例对话：

1"我的业务是在微信公众号里收款，应该用哪种支付方式？"
2
3"我要在 App 里集成微信支付，用什么方式？"
4
5"合单支付和普通支付有什么区别？什么场景需要用合单？"

需要接入代码时，Skill 会先确认你的接入模式（商户/服务商）和开发语言，然后从仓库中检索对应接口的代码示例。所有代码都是预先编写并验证过的，不是 AI 实时生成的。

示例对话：

1"帮我生成 JSAPI 下单的 Java 代码"
2
3"我要调用退款接口，用 Go 语言"
4
5"支付回调通知怎么处理？"

接入过程中遇到概念不清、参数不明、流程不熟的问题，直接提问即可。

示例对话：

1"APPID 需要怎么绑定？"
2
3"订单的状态流转是怎样的？"
4
5"退款有什么规则和限制？"

开发完成准备上线时，可以让 Skill 做一次全面检查。检查范围包括：签名验签是否按标准实现、业务逻辑是否完整、回调处理是否规范。

示例对话：

1"帮我检查一下代码有没有接入隐患"
2
3"我准备上线了，帮我做个质量评估"

接口报错时，提供 Response Header 中的 Request-Id，Skill 会自动提取错误码并匹配排查方案。排障完成后会推荐做一次接入质量评估，排查其他潜在问题。

示例对话：

1"下单接口签名报错了，Request-Id 是 08F16BEF7B2D64C6E064BAE219CF05-268443699"
2
3"调起支付时报 appid 和 mch_id 不匹配怎么办？"
4
5"支付回调一直收不到是什么原因？"

A：目前支持 Java 和 Go。

A：可以直接阅读仓库中的示例代码和参考文档来完成接入。参考文档位于 references/ 目录下。

文档是否有帮助