微信支付接入Skill

更新时间:2026.06.26
||

一、概述

本 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-payment-integration/
5            ├── SKILL.md
6            ├── references/
7            └── scripts/

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

验证是否生效:

打开 AI IDE 对话,输入"我要接入基础支付"。如果 Skill 已生效,AI IDE 会提示Use Skil 并执行同步知识库脚本 。

三、能力说明

3.1、产品选型

不确定该用哪种微信支付产品时,描述你的业务场景,Skill 会根据场景匹配推荐合适的产品。覆盖基础支付(JSAPI、APP、H5、Native、小程序、付款码、合单)、分账、商家转账、委托代扣、微信支付分等全产品线。

示例:

3.2、示例代码检索

需要接入代码时,Skill 会先确认你的接入模式(商户/服务商)和开发语言,然后从仓库中检索对应接口的代码示例。官方支持 curl、Java、Go 三种语言,代码来自官方文档,非 AI 实时生成;其他语言需经你同意后,以官方 Java 为基准翻译生成,并附免责说明。

示例:

3.3、接入质量评估

开发完成准备上线时,可以让 Skill 做一次全面检查。Skill 会以金融支付专家视角扫描接入代码,覆盖安全合规、资金链路及常见业务质量问题,按 🔴 致命 / 🟠 严重 / 🟡 建议 分级输出问题清单和修复方向。

示例:

3.4、答疑与排障

接入过程中遇到概念不清、参数不明、流程不熟的问题,直接提问即可;接口报错时,提供 Response Header 中的 Request-Id,Skill 会自动提取错误码并匹配排查方案。此外,Skill 内置了微信支付开发者 CLI 工具,支持直接查支付单和退款单状态,无需手动构造签名和请求。

示例:

四、CLI 工具使用指南

提问"帮我查一个单号的状态"

 

第一步:安装wechatpay-dev-cli 工具,已安装无需关注(流程已内置Skill中,模型会自动触发,用户执行即可)

第二步: 提供商户号并生成代签名串


第三步: 生成签名串(终端执行,无需与AI交互,无秘钥泄露风险)

第四步: 发起查询,通过CLI工具完成支付单订单查询

 

五、常见问题

Q:示例代码支持哪些开发语言?

A:官方示例代码是 curl / Java / Go 三种,其他语言可以 AI 翻译生成

Q:如何判断我的Skill是否生效了?

A:如下图所示,提示Use Skil 就代表Skill已经生效了