本文件是整包导入入口。某些 Agent 只接受 skill-name/SKILL.md 这种单 Skill zip 结构；当 hj-payment-skills 作为一个整体导入时，先读取本文件，再按任务进入下方子目录。
| 项目 | 内容 |
|---|---|
| ------ | ------ |
| Skill 版本 | 1.1.0 |
| 定位 | 汇聚支付整包入口 / 产品线分诊 / 子 Skill 导航 |
| 适用范围 | 聚合支付、二级商户入网、多次分账、共享协议、示例代码、接入治理 |
| 不承担 | 真实商户资料、密钥托管、生产配置变更 |
聚合支付和二级商户入网是两套互斥协议：
| 产品线 | 接口路径 | 签名/加密规则 | 入口 |
|---|---|---|---|
| -------- | ---------- | --------------- | ------ |
| 聚合支付 | /tradeRt/* | p0_/q*/hmac，按 key 排序后只拼 value | hj-payment-integration/SKILL.md |
| 二级商户入网 | /altFunds | method/version/data/rand_str/sign_type/mch_no/sign/sec_key，key=value&key=value | hj-joinpay-secondary-mch/SKILL.md |
| 多次分账 | /allocFunds | method/version/data/rand_str/sign_type/mch_no/sign，key=value&key=value | hj-joinpay-many-allocate/SKILL.md |
不要把聚合支付的 hmac 规则用于二级商户，也不要把二级商户的 sign/sec_key/data 规则用于聚合支付。
| 用户要做什么 | 先读 |
|---|---|
| -------------- | ------ |
| 快速了解支持能力 | 能力矩阵 |
| 判断错误怎么处理 | 错误处理矩阵 |
| 确认接口版本和协议 | 协议与版本矩阵 |
| 处理异步通知和幂等 | 回调与幂等 |
| 第一次接汇聚支付，不确定走哪条线 | hj-payment-integration/SKILL.md |
| 聚合支付初始化、签名规则、渠道选型 | hj-joinpay-aggregation-base/SKILL.md |
| 聚合支付下单 | hj-joinpay-aggregation-order/SKILL.md |
| 聚合支付查询、关单、资金查询 | hj-joinpay-aggregation-query/SKILL.md |
| 聚合支付退款 | hj-joinpay-aggregation-refund/SKILL.md |
| 二级商户入网、图片、签约 | hj-joinpay-secondary-mch/SKILL.md |
| 多次分账、完结分账、分账查询 | hj-joinpay-many-allocate/SKILL.md |
| 共享签名、通知、运行时矩阵 | hj-joinpay-pay-shared-base/SKILL.md |
如果后续 hj-payment-skills 新增子 Skill、参考资料或脚本，优先到官方仓库下载最新的 Skill 安装包：
下载后按目标 Agent 的导入方式重新安装或覆盖本地旧版本，避免只复制单个新增文件导致目录索引、依赖关系或共享规则不同步。
如果目标 Agent 只支持单个 Skill zip，请导入包含本文件的整包 zip，zip 内层级应为：
hj-payment-skills/
├── SKILL.md
├── hj-payment-integration/
├── hj-joinpay-pay-shared-base/
├── hj-joinpay-aggregation-base/
├── hj-joinpay-aggregation-order/
├── hj-joinpay-aggregation-query/
├── hj-joinpay-aggregation-refund/
├── hj-joinpay-secondary-mch/
└── hj-joinpay-many-allocate/
如果目标 Agent 支持多个 Skill 目录，也可以只复制或分别导入各子目录。
共 1 个版本