---
url: "https://pay.weixin.qq.com/doc/v3/partner/4019636341.md"
title: "微信支付接入Skill"
doc_id: 4019636341
---

>更新时间：2026.06.29

## 一、概述

本 Skill 为接入微信支付基础支付的开发者提供了一站式的智能辅助能力，包括产品选型、官方示例代码检索、接入质量评估、答疑与排障。开发者在支持 Skill 的 AI IDE 中打开项目，通过对话即可获得接入过程中的指引与帮助。[GitHub仓库地址](https://github.com/wechatpay-apiv3/wechatpay-skills)

## 二、快速开始

引入方式：

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

方式一：命令行加载

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

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

方式二：Clone 仓库

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

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

方式三：手动复制目录

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

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

```
your-project/
└── .cursor/
    └── skills/
        └── wechatpay-payment-integration/
            ├── SKILL.md
            ├── references/
            └── scripts/
```

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

验证是否生效：

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

## 三、能力说明

### 3.1、产品选型

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

示例：

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/e8cef16b6bff77f50136378c6e27ef49.png)

### 3.2、示例代码检索

需要接入代码时，Skill 会先确认你的接入模式（商户/服务商）和开发语言，然后从仓库中检索对应接口的代码示例。官方支持 curl、Java、Go 三种语言，代码来自官方文档。

示例：

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/d16c19e3ee1786abdca08da46fdf90b6.png)

### 3.3、接入质量评估

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

示例：

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/57fdc9abafa7479e329ff639bb3c30b3.png)

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/f73c4a330ba4026c41ad0eba6e4117b5.png)

### 3.4、答疑与排障

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

示例：

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/c913ca70b2d38f0a938107123caca4f9.png)

## 四、CLI 工具使用指南

wechatpay-dev-cli 是一个面向微信支付 APIv3 的命令行排障工具，主要用于在本地直接发起查单请求，确认订单的真实交易状态，从而定位查单失败、接口报错等接入排障问题。

### 4.1 支持哪些能力

CLI 的核心能力是 查询支付单和退款单，帮助开发者在不写代码的情况下，直接向微信支付服务端发起 APIv3 查询并拿到原始响应。具体包括：

| 能力 | 说明 |
| --- | --- |
| 查询支付单 | 通过商户订单号（ `out_trade_no`）或微信支付订单号（ `transaction_id`）查询一笔交易的真实支付状态、金额、支付时间等信息 |
| 查询退款单 | 通过商户退款单号（ `out_refund_no`） 查询某笔退款的处理状态、退款金额、退款渠道 |

### 4.2 如何使用

注意

- 本文所有示例中的商户号均为测试商户号，仅用于演示命令格式，并非真实生产商户号。

- CLI 全程不接触商户密钥，仅负责组装请求参数和携带开发者提供的签名结果发起查询。


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

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/09c90606b56b6dbffcf164a4a981245b.png)

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

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/a4a922516f13cfd82933daba708eb178.png)

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

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/a20e22ea7a88e64bf52bafc2f6a8189f.png)

第三步： 生成签名串（终端执行，无需与AI交互，无秘钥泄露风险）

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/1e5bb1c804c60f4374554dd1b259d9dc.png)

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

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/c151a8a2f36e4bc64287e6e7a3852e8c.png)

## 五、常见问题

### Q：示例代码支持哪些开发语言？

A：官方示例代码是 curl / Java / Go 三种，开发者可参考官方示例生成

### Q：如何判断我的Skill是否生效了？

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

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/149d648b7cb1dd02d97ff5a5e9595967.png)