商品券接入Skill

更新时间：2026.03.23

一、概述

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

引入方式：

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

方式一：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        └── wxpay-product-coupon/
5            ├── SKILL.md
6            └── references/

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

验证是否生效：

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

不确定该用哪种券时，描述你的业务场景，Skill 会从优惠范围（全场 / 单品）、券类型（满减 / 折扣 / 兑换）、使用模式（单券 / 多次优惠）三个维度进行匹配，覆盖全部 10 种券类型。

示例对话：

1"我想给全场商品打 8 折，应该用哪种券？"
2
3"我要做单品满 100 减 20 的活动"
4
5"多次优惠和单券有什么区别？分别适合什么场景？"

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

示例对话：

1"帮我生成创建单品满减券的 Java 代码"
2
3"我要调用发券接口，用 Go 语言"
4
5"核销接口怎么调？"

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

示例对话：

1"brand_id 在哪里获取？"
2
3"券的状态流转是怎样的？"
4
5"发券前需要做哪些准备工作？

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

示例对话：

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

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

示例对话：

1"签名报错了，Request-Id 是 08F16BEF7B2D64C6E064BAE219CF05-268578704"
2
3"调用创券接口返回参数错误"

A：目前支持 Java 和 Go。

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

文档是否有帮助

更多支持