前言¶
接匯付（斗拱）支付時，常見難點不在「會不會調 HTTP」，而在字段是否對齊官方 DTO、簽名驗籤、異步通知與支付終態、冪等與查單補償，以及沙箱聯調與上線後的通道排查。文檔分散在 SDK 與接口說明裏，問通用大模型又容易漏渠道差異或編造錯誤碼。
下面介紹 SkillHub 上的 匯付支付集成（@user_93f1fdbc/huifu-pay-integration，v1.4.0）。它由 上海匯付支付有限公司 以 enterprise 來源發佈，分類爲 dev-programming，標籤 requires_api_key=false，用於在 Agent 對話裏按官方能力邊界協助交易接入與排障，而不是替代商戶密鑰與生產配置。
這是什麼¶
匯付支付集成 面向匯付支付 / 斗拱支付（Huifu Payment）的 交易接入與開發排障：聚合支付、託管支付、餘額支付、checkout-js 與各端收銀臺，以及 Java / PHP / Python 官方 SDK、完整字段與 DTO、簽名驗籤、異步通知與 Webhook、冪等、支付終態、查單補償、本地沙箱與上線排查。
商戶 進件、開戶、資料維護、費率或業務開通 不在本 Skill 範圍內，應使用 huifu-merchant-onboarding。若單次任務既要開戶開通又要支付聯調，需要 同時啓用兩個 Skill，端到端請求才能對齊官方分工。
核心功能¶
以下能力均來自 SkillHub 頁面簡介，按接入鏈路歸納。
支付產品與收銀¶
- 聚合支付、託管支付、餘額支付
checkout-js與各端收銀臺
渠道與交易類型¶
- 渠道：微信、支付寶、銀聯、抖音等
- 交易：預下單 / 下單、查單、關單、退款、合單、拆單 / 分賬查詢、對賬
餘額與輔助接口¶
- 餘額手續費試算
- 付款關係提交
- 短信驗證碼
工程與穩定性¶
- Java / PHP / Python 官方 SDK，完整字段 / DTO
- 簽名驗籤
- 異步通知 / Webhook
- 冪等、支付終態、查單補償
- 本地沙箱與上線排查
安裝與啓用¶
SkillHub 官方頁面給出的安裝方式，是讓 AI 按統一安裝文檔處理座標包，而不是手寫業務代碼。
方式一：提示詞安裝（頁面推薦）¶
將下面提示發給當前使用的 AI Agent：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_93f1fdbc/huifu-pay-integration`。
方式二：SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝 Skill 時 必須 使用 --dir 指向當前 Agent 的 skills 目錄；裝到默認 ./skills/ 可能不會被識別。常見路徑如下（以安裝文檔爲準）：
| Agent | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝本 Skill 示例：
skillhub install @user_93f1fdbc/huifu-pay-integration --dir ~/.cursor/skills/
將 ~/.cursor/skills/ 換成你當前環境對應目錄即可。Codex、Claude Code 等同理，僅路徑不同。
典型用法¶
本 Skill 基於通用 SKILL.md 格式，頁面未附帶獨立業務代碼倉庫；典型用法是在已安裝的前提下，用自然語言描述場景，讓 Agent 按匯付官方 SDK 與接口約束生成或校對實現。
- 預下單 / 下單：說明渠道（如微信、支付寶）、收銀形態（聚合、託管或收銀臺）、金額與商戶單號，要求對照 DTO 字段與簽名規則組請求。
- 異步通知：描述 Webhook 或異步通知處理邏輯草案，要求驗籤、冪等更新訂單、區分支付終態，並說明重複回調時的處理。
- 查單與補償：支付結果不明時，要求走查單接口並與本地訂單狀態對齊，必要時給出查單補償步驟。
- 退款 / 合單 / 分賬：說明原交易信息與分賬規則，要求覆蓋關單、退款、拆單 / 分賬查詢與對賬相關接口。
- 聯調與上線：區分沙箱與生產配置，列出簽名、密鑰與通道類問題的排查順序（不輸出真實密鑰）。
若對話涉及 開戶、進件、業務開通，應顯式切換到 huifu-merchant-onboarding，或與本 Skill 聯用。
適用場景與注意¶
適合誰
- 正在接入斗拱 / 匯付支付的後端或全棧開發者
- 需要統一對照 Java / PHP / Python SDK、DTO 與簽名驗籤的團隊
- 處理異步通知、冪等、終態與查單補償的維護人員
限制與注意
requires_api_key=false表示 Skill 元數據不強制綁定 API Key；生產商戶號、密鑰、證書仍由你在安全環境中配置，勿寫入對話或倉庫明文。- 進件與支付能力拆分在兩個 Skill；不要指望單一 Skill 覆蓋開戶到收款全鏈路。
- 頁面統計（截至資料抓取）：評分 100000，下載 8377；以 SkillHub 實時頁面爲準。
- 版本以 SkillHub 爲準，當前爲 v1.4.0。
結尾¶
匯付支付集成 把斗拱交易接入、SDK/DTO、簽名驗籤、異步通知與排障知識收斂到 Agent 可執行的 Skill 裏，並與 huifu-merchant-onboarding 在職責上劃清邊界。需要安裝或查看說明時，可打開官方地址：
- API 頁：https://api.skillhub.cn/user_93f1fdbc/huifu-pay-integration
- SkillHub 頁：https://www.skillhub.cn/skills/user_93f1fdbc/huifu-pay-integration
