菜单
汇聚支付聚合支付基础 Skill：公共参数、MD5/RSA 签名方式、支付渠道选型、参数命名规范和错误码。当开发者首次接入汇聚聚合支付或需要了解公共配置时使用。所有聚合支付 Skill 的前置依赖。触发词：聚合支付接入、JoinPay SDK、汇聚支付初始化、支付类型、FrpCode。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | hj-joinpay-aggregation-base |
| display_name | 汇聚支付聚合支付基础 |
| description | 汇聚支付聚合支付基础 Skill：公共参数、MD5/RSA 签名方式、支付渠道选型、参数命名规范和错误码。当开发者首次接入汇聚聚合支付或需要了解公共配置时使用。所有聚合支付 Skill 的前置依赖。触发词：聚合支付接入、JoinPay SDK、汇聚支付初始化、支付类型、FrpCode。 |
| 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":["JOINPAY_MERCHANT_NO","JOINPAY_MERCHANT_KEY","JOINPAY_RSA_PRIVATE_KEY","JOINPAY_RSA_PUBLIC_KEY"]}}} |
本 Skill 是所有汇聚聚合支付业务 Skill 的公共基座，包含 SDK 初始化、签名方式、支付渠道选型和公共参数。
| 项目 | 内容 |
|---|---|
| Skill 版本 | 1.1.0 |
| 定位 | 聚合支付公共基座 |
| 适用范围 | 聚合支付初始化、产品选型、公共参数 |
完整流程 → ../hj-payment-integration/shared-rules/credential-collection.md
以下场景不需要收集：仅咨询业务知识、仅查看示例代码、参数已收集过。
MD5/RSA 签名规则、代码实现和错误排查 → ../hj-payment-integration/shared-rules/signing-constraints.md
接口地址、参数固定值、命名规范 → ../hj-payment-integration/shared-rules/interface-stability.md
本 Skill 需要以下环境变量，由开发者从商户后台获取后通过环境变量注入（严禁硬编码）：
| 环境变量 | 用途 | 敏感级别 |
|---|---|---|
JOINPAY_MERCHANT_NO | 商户号 | 普通 |
JOINPAY_MERCHANT_KEY | MD5 签名密钥（32位） | 高 |
JOINPAY_RSA_PRIVATE_KEY | RSA 私钥（请求签名） | 高 |
JOINPAY_RSA_PUBLIC_KEY | RSA 公钥（响应验签） | 中 |
| 渠道 | 前缀 | 支持的支付方式 | 典型场景 |
|---|---|---|---|
| 微信 | WEIXIN_ | 主扫(NATIVE)、被扫(CARD)、APP、APP3、H5、H5+、公众号(GZH)、小程序(XCX)、收银台(SYT)、小程序插件(CJXCX) | 社交生态内支付 |
| 支付宝 | ALIPAY_ | 主扫(NATIVE)、被扫(CARD)、APP、H5、服务窗(FWC)、收银台(SYT) | 电商/线下收款 |
| 银联 | UNIONPAY_ | 主扫(NATIVE)、被扫(CARD)、APP、H5、收银台(SYT)、云微小程序(WXMP) | 大额支付/银行卡 |
开始选型
│
├─ 用户在微信环境内？
│ ├─ 公众号H5页面？ → WEIXIN_GZH（需OpenId + AppId）
│ ├─ 微信小程序？ → WEIXIN_XCX（需OpenId + AppId）
│ └─ 普通H5页面？ → WEIXIN_H5 或 WEIXIN_H5+
│
├─ 用户在APP内？
│ ├─ 原生iOS/Android APP？ → {渠道}_APP
│ └─ 跨平台/H5嵌入APP？ → {渠道}_H5
│
├─ PC端网页？
│ └─ 展示二维码让用户扫 → {渠道}_NATIVE（主扫）
│
├─ 线下实体店收银？
│ └─ 商户扫用户付款码 → {渠道}_CARD（被扫，需AuthCode + 终端信息）
│
└─ 需要统一收银入口？
└─ {渠道}_SYT（收银台，自动识别用户环境）
完整 FrpCode 映射表 → references/支付渠道与交易类型对比.md
汇聚支付采用前缀分类命名，参数名由服务端定义，不得擅自修改或猜测：
| 前缀 | 含义 | 示例 |
|---|---|---|
p0 ~ p9 | 通用基础参数 | p0_Version, p1_MerchantNo, p3_Amount, p9_NotifyUrl |
q1 ~ qz | 扩展/渠道参数 | q1_FrpCode, qa_TradeMerchantNo, q5_OpenId |
ra ~ rz | 响应字段 | ra_Code, rb_CodeMsg, rc_Result |
hmac | 签名字段 | 请求和响应均含此字段 |
详细禁止推断列表 → interface-stability.md §参数命名规范
1. 获取商户配置 → 2. 确认签名方式 → 3. 确认支付渠道(FrpCode) → 4. 配置环境变量 → 5. 进入语言适配 → 6. 调用业务接口
joinpay:
merchant-no: ${JOINPAY_MERCHANT_NO}
merchant-key: ${JOINPAY_MERCHANT_KEY}
rsa-private-key: ${JOINPAY_RSA_PRIVATE_KEY}
rsa-public-key: ${JOINPAY_RSA_PUBLIC_KEY}
base-url: ${JOINPAY_BASE_URL:https://trade.joinpay.cc}
notify-url: ${JOINPAY_NOTIFY_URL}
sign-type: ${JOINPAY_SIGN_TYPE:MD5}
真正跨语言共用的协议规则：
当前仓库 Java 内容最完整。Python、Go、PHP 提供标准库实现示例。
SDK 能力矩阵 → server-sdk-matrix.md 代码示例索引 → 接口索引.md
"汇聚支付"、"JoinPay"、"聚合支付接入"、"FrpCode"、"交易类型"、"支付渠道"、"微信支付"、"支付宝支付"、"银联支付"
| 文件 | 内容 |
|---|---|
| signing-rules.md | MD5/RSA 签名规则（语言无关） |
| async-notify.md | 异步通知规则（语言无关） |
| server-sdk-matrix.md | 服务端多语言能力矩阵 |
| 支付渠道与交易类型对比.md | FrpCode 映射表、选型决策树 |
| 开发必要参数说明.md | 各渠道参数获取方式 |
| 参数命名规范与固定值.md | 参数前缀规则、固定值约束 |
| 订单状态流转.md | 支付/退款状态流转、关单规则 |
| 错误码.md | TOP 20 错误码速查 |
| 响应码完整列表.md | 完整响应码（含退款专用） |
| 接入质量检查清单.md | 签名验签、业务逻辑完整性检查 |
| 接口索引.md | 四语言 x 7接口 代码示例索引 |
| quickstart-templates/README.md | 快速接入模板使用指南 |
汇聚支付（JoinPay）完整接入技能包总入口。用于在单个 Skill 导入环境中承载聚合支付、二级商户入网、分账方入网与结算、延迟分账、多次分账、共享签名协议、异步通知、示例代码和接入治理资料。触发词：汇聚支付接入、JoinPay接入、聚合支付、二级商户入网、分账方入网、分账方结算、延迟分账、多次分账、secondaryMch、altmch、altSettle、altHandle。
汇聚支付聚合支付下单 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接入、聚合支付选型、二级商户入网、分账方入网、分账方结算、延迟分账、多次分账。