技能介绍

解决的问题

接汇聚支付时常见卡点不是单个接口，而是三条协议混用：/tradeRt/* 聚合支付、/altFunds 二级商户入网、/allocFunds 多次分账各自签名和参数规则不同。把聚合支付的 p0_、q*、hmac 规则套到二级商户，或把二级商户的 sign、sec_key、data 规则套到聚合支付，都会导致联调反复失败。该技能把入口、分诊和子目录导航放在一起，先判断任务属于哪条线，再进入对应文档。

如何工作

整包入口：从当前文件读取，再按任务进入 hj-payment-integration、hj-joinpay-aggregation-*、hj-joinpay-secondary-mch 或 hj-joinpay-many-allocate。
协议边界：聚合支付走 /tradeRt/*，按 key 排序后只拼 value；二级商户走 /altFunds，使用 method、version、data、rand_str、sign、sec_key 等字段；多次分账走 /allocFunds。
关键步骤：快速查看能力矩阵，处理回调时用错误处理矩阵，确认版本用协议与版本矩阵；第一次接入不确定路径时先读 hj-payment-integration/SKILL.md。
子能力：聚合支付覆盖初始化、下单、查询、关单、资金查询和退款；二级商户覆盖入网、图片、签约；多次分账覆盖分账、完结分账和分账查询。

边界与注意

该技能面向接入导航和示例代码，不承担真实商户资料、密钥托管和生产配置变更。目标 Agent 若只接受单 Skill zip，通常需要包含本入口的整包 zip；若支持多目录，也可以分别导入子目录。后续新增子 Skill 或共享规则变化时，优先同步官方仓库 Joinpay-Official/hj-payment-skills 的完整结构，避免只复制单个文件造成目录索引、依赖关系或共享规则不同步。

截图预览

使用场景

后端联调聚合支付下单时，核对 /tradeRt/* 的 p0_、q*、hmac 拼接规则，避免误用二级商户 sign 和 sec_key。
商户入网接入时，按 /altFunds 的 method、version、data、rand_str、sign 等字段整理请求结构。
处理多次分账请求时，区分 /allocFunds 与 /tradeRt/* 的签名参数，确认分账、完结分账和查询入口。
排查异步通知或幂等问题时，从协议边界矩阵开始，定位应读共享签名、通知还是子 Skill 文档。

适合人员

对接支付网关的后端工程师，需要在联调前确认聚合支付与二级商户入网的协议边界。
负责商户入网流程的工程师或产品，需要按 /altFunds 字段整理签约、图片和资料提交顺序。
处理分账结算的后端工程师，需要区分多次分账 /allocFunds 与聚合支付退款链路，避免接口参数混用。
维护 Agent 技能包的工程师，需要把整包 zip 或子目录导入目标 Agent，并同步共享签名与通知规则。

汇聚支付与分账接入