前言¶
接微信支付時,常見難點不在「能不能調接口」,而在產品選型:公衆號裏用 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 官方簡介,未在資料中出現的接口名、配置項不作延伸:
- 全場景產品覆蓋:JSAPI 支付、小程序支付、APP 支付、H5 支付、Native 支付、付款碼支付。
- 選型與集成指導:在 Agent 對話中按業務形態(公衆號、小程序、原生 App、移動瀏覽器、PC 掃碼、線下收銀等)對齊應使用的支付產品,並沿商戶平臺接入思路組織步驟。
- 社區分發形態:標準 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 內指引輸出接入路徑。可復現的提問方式例如:
- 說明載體:「我們只有微信小程序,需要用戶下單後支付。」
- 說明約束:「已有微信支付商戶號,需要區分 JSAPI 和小程序支付該走哪條。」
- 說明階段:「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