微信支付集成 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
羽毛球分组比赛记分
小程序二维码

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

小夜