前言¶

接入汇付支付（斗拱支付，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