菜单
汇聚支付（JoinPay）完整接入技能包总入口。用于在单个 Skill 导入环境中承载聚合支付、二级商户入网、分账方入网与结算、延迟分账、多次分账、共享签名协议、异步通知、示例代码和接入治理资料。触发词：汇聚支付接入、JoinPay接入、聚合支付、二级商户入网、分账方入网、分账方结算、延迟分账、多次分账、secondaryMch、altmch、altSettle、altHandle。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
汇聚支付聚合支付基础 Skill：公共参数、MD5/RSA 签名方式、支付渠道选型、参数命名规范和错误码。当开发者首次接入汇聚聚合支付或需要了解公共配置时使用。所有聚合支付 Skill 的前置依赖。触发词：聚合支付接入、JoinPay SDK、汇聚支付初始化、支付类型、FrpCode。
汇聚支付聚合支付下单 Skill：覆盖微信公众号/小程序/APP、支付宝 JS / 正扫、银联 JS / 正扫、微信 / 支付宝 / 银联付款码等全场景聚合支付下单。参数表和业务规则按协议字段组织。当开发者需要创建聚合支付订单时使用。触发词：聚合支付下单、微信支付下单、支付宝下单、银联下单、二维码支付、付款码支付、uniPay。
汇聚支付分账方入网与结算 Skill：覆盖分账方添加、修改、查询、资质图片上传、协议签约、手工结算、结算查询、自动结算查询和账户余额查询。适用于 altmch.create、altmch.modify、altmch.query、altMchPics.*、altMchSign.*、altSettle.launch、altSettle.get、altSettle.getAutoSettle、altAccount.get 等 /allocFunds 接口。触发词：分账方入网、分账方结算、分账方签约、分账方图片、altmch、altSettle、altAccount。
汇聚支付延迟分账与多次分账 Skill：覆盖单次延迟分账请求、延迟分账查询、多次分账请求、完结分账、查询单笔分账、查询所有分账，以及金额规则、异步通知、状态与响应码。适用于 altHandle.singleLaterAllocate、altHandle.allocateQuery、altHandle.manyLaterAllocate、altHandle.finishAllocate、altHandle.altManyOrderQuery、altHandle.altManyTotalQuery 等 /allocFunds 接口。触发词：延迟分账、单次延迟分账、分账查询、多次分账、完结分账、altHandle、singleLaterAllocate、allocateQuery。
汇聚支付共享基础资料 Skill：集中收纳 MD5/RSA 签名规则、异步通知规则、服务端多语言 SDK 矩阵和发布治理清单。适合作为聚合支付体系的公共入口。触发词：签名规则、异步通知、多语言 SDK、发布检查、共享基础资料。
汇聚支付接入总入口 Skill。用于帮助开发者和 AI 在聚合支付、二级商户入网、分账方入网与结算、延迟分账、多次分账各业务 Skill 与共享协议资料之间做正确路由，先完成场景判断，再进入对应的基础 Skill 和业务 Skill。触发词：汇聚支付接入、JoinPay接入、聚合支付选型、二级商户入网、分账方入网、分账方结算、延迟分账、多次分账。
| name | hj-payment-skills |
| display_name | 汇聚支付技能包 |
| description | 汇聚支付（JoinPay）完整接入技能包总入口。用于在单个 Skill 导入环境中承载聚合支付、二级商户入网、分账方入网与结算、延迟分账、多次分账、共享签名协议、异步通知、示例代码和接入治理资料。触发词：汇聚支付接入、JoinPay接入、聚合支付、二级商户入网、分账方入网、分账方结算、延迟分账、多次分账、secondaryMch、altmch、altSettle、altHandle。 |
| version | 1.1.0 |
| author | hj-payment-skills |
| homepage | https://www.joinpay.com |
| license | MIT |
| compatibility | ["skillhub"] |
| dependencies | ["hj-joinpay-pay-shared-base"] |
| metadata | {"skillhub":{"requires":{"config":[]}}} |
本文件是整包导入入口。某些 Agent 只接受 skill-name/SKILL.md 这种单 Skill zip 结构；当 hj-payment-skills 作为一个整体导入时，先读取本文件，再按任务进入下方子目录。
| 项目 | 内容 |
|---|---|
| Skill 版本 | 1.1.0 |
| 定位 | 汇聚支付整包入口 / 产品线分诊 / 子 Skill 导航 |
| 适用范围 | 聚合支付、二级商户入网、分账方入网与结算、延迟分账、多次分账、共享协议、示例代码、接入治理 |
| 不承担 | 真实商户资料、密钥托管、生产配置变更 |
聚合支付、二级商户入网、分账方入网与结算、延迟分账/多次分账属于不同协议或 method 族：
| 产品线 | 接口路径 | 签名/加密规则 | 入口 |
|---|---|---|---|
| 聚合支付 | /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-alt-mch-settlement/SKILL.md |
| 延迟分账/多次分账 | /allocFunds | method/version/data/rand_str/sign_type/mch_no/sign，key=value&key=value | hj-joinpay-many-allocate/SKILL.md |
不要把聚合支付的 hmac 规则用于 JSON method 接口，也不要把二级商户的 sign/sec_key/data 规则用于 /allocFunds。
| 用户要做什么 | 先读 |
|---|---|
| 快速了解支持能力 | 能力矩阵 |
| 判断错误怎么处理 | 错误处理矩阵 |
| 确认接口版本和协议 | 协议与版本矩阵 |
| 处理异步通知和幂等 | 回调与幂等 |
| 第一次接汇聚支付，不确定走哪条线 | 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-alt-mch-settlement/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-alt-mch-settlement/
└── hj-joinpay-many-allocate/
如果目标 Agent 支持多个 Skill 目录，也可以只复制或分别导入各子目录。