微信支付集成 Skill:商户全场景接入的 Agent 指导

前言

接微信支付时,常见难点不在「能不能调接口」,而在产品选型:公众号里用 JSAPI、小程序里走小程序支付、App 与 H5、扫码 Native、柜台付款码,文档分散、回调与签名规则又容易踩坑。自己翻商户平台文档往往要反复对照场景。下面介绍 SkillHub 上的社区 Skill「微信支付集成」,把全场景选型与集成要点收敛成 Agent 可遵循的 SKILL.md 指引。

这是什么

「微信支付集成」是 SkillHub 坐标 @user_8509461a/wechat-pay-integration 下的社区 Skill(community),当前版本 1.0.0,分类为 business-ops,发布者为 user_8509461a;SkillHub 页面标注作者为蜀企投管(四川省)企业管理有限公司。

定位一句话:围绕微信支付商户平台的接入最佳实践,覆盖 JSAPI、小程序、APP、H5、Native、付款码等产品的选型与集成指导。Skill 标签含 requires_api_key=true,表示实际对接需要商户侧 API 密钥等凭证,由你在安全环境中自行配置,Skill 本身不替代商户平台开户与合规流程。

核心功能

以下能力均来自 SkillHub 官方简介,未在资料中出现的接口名、配置项不作延伸:

  1. 全场景产品覆盖:JSAPI 支付、小程序支付、APP 支付、H5 支付、Native 支付、付款码支付。
  2. 选型与集成指导:在 Agent 对话中按业务形态(公众号、小程序、原生 App、移动浏览器、PC 扫码、线下收银等)对齐应使用的支付产品,并沿商户平台接入思路组织步骤。
  3. 社区分发形态:标准 SKILL.md 格式,便于在 Cursor、Claude Code、Codex 等支持 Skills 的客户端中加载,由模型按 Skill 内指引回答集成问题。

SkillHub 统计(以抓取资料为准):评分 100000,下载 2716 次,安装 169 次。

安装与启用

安装分两种方式:让 AI 按官方安装说明执行,或本机已装 SkillHub CLI 后命令行安装。

方式一:提示词交给 AI

SkillHub 页面给出的安装提示为:请 Agent 根据 SkillHub 安装与优先源配置 安装 @user_8509461a/wechat-pay-integration。

把上述要求发给当前使用的 Coding Agent 即可;Agent 会按文档检查 skillhub CLI、选择正确的 skills 目录并完成安装。

方式二:SkillHub CLI

先确认是否已安装 CLI:

command -v skillhub && skillhub --version

未安装时,可按官方文档执行完整安装(含 CLI 与默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill 时,必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被客户端识别。示例:

skillhub install @user_8509461a/wechat-pay-integration --dir <当前 Agent 的 skills 目录>

常用路径(摘自 SkillHub 安装文档,按你实际使用的客户端择一):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

安装后按各客户端要求刷新或重启,使 Skill 进入可用列表。

典型用法

官方页面未提供单独的可复制代码示例;典型用法是在已启用 Skill 的对话里描述业务场景,由 Agent 结合 Skill 内指引输出接入路径。可复现的提问方式例如:

  1. 说明载体:「我们只有微信小程序,需要用户下单后支付。」
  2. 说明约束:「已有微信支付商户号,需要区分 JSAPI 和小程序支付该走哪条。」
  3. 说明阶段:「Native 扫码支付从下单到回调校验要注意什么顺序。」

因 requires_api_key=true,涉及 AppID、商户号、API 密钥、证书等敏感信息时,应在本地环境或密钥管理服务中配置,勿把完整密钥贴进聊天记录。Agent 宜只引用字段含义与配置位置,不编造未在 Skill 或商户平台文档中出现的参数名。

适用场景与注意

适合谁

  • 正在或计划接入微信支付商户平台的后端、全栈、小程序开发者。
  • 需要在多种支付产品之间做选型、希望减少反复翻分散文档的团队。
  • 已使用 Cursor、Claude Code、Codex 等 Skills 能力,希望把「微信支付接入」固化为可重复调用的领域知识包。

限制与注意

  • 来源为社区 Skill,集成细节以微信支付商户平台现行文档与审核规则为准;上线前仍需自行联调与合规检查。
  • 评分与下载量来自 SkillHub 展示,会随时间变化,选型时可结合简介与自身场景判断,而非单独依赖热度数字。
  • 本 Skill 侧重接入与选型指导,不替代法务、财务对收单资质与合同条款的确认。

结尾

「微信支付集成」把 JSAPI、小程序、APP、H5、Native、付款码等场景的选型与集成思路装进标准 Skill,适合在 Agent 工作流里做商户接入问答与步骤梳理。官方 Skill 页与 API 入口:

  • https://www.skillhub.cn/skills/user_8509461a/wechat-pay-integration
  • https://api.skillhub.cn/user_8509461a/wechat-pay-integration
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜