前言¶

接入匯付支付（斗拱支付，Huifu Payment）時，商戶進件是繞不開的第一關：企業、個體工商戶、小微商戶和無執照個人商戶的入網要求不同，要準備的資質、圖片和字段也不一樣；入網之後還要做業務開通、結算配置、費率維護和狀態查詢。如果每次都手工查文檔拼參數，很容易漏字段或簽名驗簽出錯。

下面介紹的 Skill「匯付商戶進件集成」（@huifu/huifu-merchant-onboarding）把這部分能力做成了統一入口，和支付交易側的 huifu-pay-integration 分工明確：進件、開戶、進件狀態與商戶管理走這個 Skill，支付交易、退款、對賬、checkout-js 與支付終態走另一個 Skill。

這是什麼¶

「匯付商戶進件集成」是一個面向開發場景的 Agent Skill，由上海匯付支付有限公司發佈，SkillHub 分類爲 dev-programming，當前版本 1.1.0，需要配置 API Key 才能使用（標籤 requires_api_key=true）。

它解決的問題是：把商戶進件、用戶開戶與後續管理中分散的接口能力整理成可被 Agent 調用的步驟，包括資料與圖片上傳、業務開通、配置修改和狀態查詢，減少手工拼裝參數和反覆翻文檔的成本。

核心功能¶

根據 SkillHub 頁面給出的簡介，這個 Skill 覆蓋的能力可以歸爲四組。

1、進件與開戶。支持企業、個體工商戶、小微商戶及無執照個人商戶入網，包含 KYC 流程、資料與圖片上傳，以及統一頁面進件。企業用戶和個人用戶的開戶、業務入駐也在這一組內。

2、業務與配置管理。支持業務的開通、補開和修改；基本信息維護；子賬戶與結算配置；商戶詳情及申請狀態查詢；商戶狀態查看。

3、費率與通知。支持費率配置和多費率場景；短信能力；電子合同；審覈、業務和協議通知的接收與排障。

4、渠道與擴展。支持下級商戶權限管理，以及微信、支付寶渠道的配置與實名。

開發側提供 Java、PHP、Python 三種官方 SDK，Skill 內含完整的字段與 DTO 說明，並覆蓋簽名與驗籤環節，便於在本地和線上排查參數問題。

安裝與啓用¶

Skill 以通用 SKILL.md 格式提供，座標爲 @huifu/huifu-merchant-onboarding，在 SkillHub 頁面按官方引導安裝後即可在 Agent 環境中按名稱引用。

啓用前確認兩點：一是已在匯付開放平臺申請商戶權限並取得 API Key；二是當前任務只涉及進件、開戶與商戶管理。如果任務同時涉及支付交易、退款、對賬或支付終態判斷，需要把 huifu-pay-integration 一併加入，兩個 Skill 聯用。

典型用法¶

1、準備進件資料。按商戶類型整理資質文件與圖片，企業、個體工商戶、小微和無執照個人商戶的材料要求不同，先確認商戶類型再收集，避免後續補件。

2、調用進件能力。通過統一頁面進件或接口提交資料與圖片，Skill 會給出需要填寫的字段與 DTO 結構，按提示逐項提供。

3、提交後查詢狀態。使用詳情與申請狀態查詢能力跟蹤審覈進度，審覈、業務和協議通知會異步到達，結合通知內容定位卡點。

4、配置業務與結算。審覈通過後，按需做業務開通、補開或修改，配置子賬戶、結算方式、費率（含多費率），並按需完成微信、支付寶渠道配置與實名。

5、聯用支付側 Skill。當流程走到真實支付、退款、對賬或支付終態處理時，切換到 huifu-pay-integration 完成後續環節。

適用場景與注意¶

適合正在接入匯付支付或斗拱支付、且當前任務集中在商戶入網、KYC、開戶和商戶管理的開發場景。已經跑通支付鏈路、只做交易和對賬的團隊，用 huifu-pay-integration 即可，不必引入本 Skill。

需要注意三點。一是這個 Skill 標註需要 API Key，運行環境必須能訪問匯付接口並妥善保管密鑰；二是商戶進件涉及審覈與協議通知，結果不是即時返回的，排障時要同時看申請狀態和異步通知；三是支付交易、退款、對賬、checkout-js 與支付終態不在本 Skill 範圍內，任務跨階段時需要兩個 Skill 聯用。

結尾¶

「匯付商戶進件集成」的價值在於把商戶入網、KYC、開戶和後續管理這些環節收斂到一個 Skill 裏，配合官方 SDK、完整 DTO 和簽名驗籤說明，減少手工拼參數和查文檔的時間。官方地址：https://api.skillhub.cn/huifu/huifu-merchant-onboarding