菜单
汇聚支付聚合支付查询 Skill：订单查询、关闭订单、资金管控订单查询。当开发者需要查询支付结果、关闭未支付订单、查询资金管控状态时使用。触发词：订单查询、关单、资金查询、queryOrder、closeOrder、queryFundsControlOrder。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | hj-joinpay-aggregation-query |
| display_name | 汇聚支付聚合支付查询 |
| description | 汇聚支付聚合支付查询 Skill：订单查询、关闭订单、资金管控订单查询。当开发者需要查询支付结果、关闭未支付订单、查询资金管控状态时使用。触发词：订单查询、关单、资金查询、queryOrder、closeOrder、queryFundsControlOrder。 |
| version | 1.1.0 |
| author | hj-payment-skills |
| homepage | https://www.joinpay.com |
| license | MIT |
| compatibility | ["skillhub"] |
| dependencies | ["hj-joinpay-aggregation-base"] |
| metadata | {"skillhub":{"requires":{"config":["JOINPAY_MERCHANT_NO","JOINPAY_MERCHANT_KEY","JOINPAY_RSA_PRIVATE_KEY","JOINPAY_RSA_PUBLIC_KEY"]}}} |
覆盖订单查询、关闭订单、资金管控订单查询。
| 项目 | 内容 |
|---|---|
| Skill 版本 | 1.1.0 |
| 定位 | 聚合支付查询与关单 |
| 适用范围 | 订单查询、关闭订单、资金管控订单查询 |
| 项目 | 引用 |
|---|---|
| 凭据收集（代码生成前必须完成） | credential-collection.md （查询/关单只需 merchant_no + 密钥，无需 notify_url） |
| 签名硬约束 | signing-constraints.md |
| 接口稳定性 | interface-stability.md |
以下场景不需要收集参数：仅咨询业务知识、仅查看示例代码、参数已收集过。
| 项目 | 内容 |
|---|---|
| 接口名称 | 订单查询 |
| 请求方式 | HTTP POST (form-urlencoded) |
| 接口路径 | /tradeRt/queryOrder |
| 完整测试URL | https://trade.joinpay.cc/tradeRt/queryOrder |
| p0_Version | 2.6 |
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| p0_Version | 是 | 接口版本，固定 2.6 | 2.6 |
| p1_MerchantNo | 是 | 商户号 | 888100500008456 |
| p2_OrderNo | 是 | 商户订单号 | ORDER20260413001 |
| hmac | 是 | 签名 | — |
| 参数 | 说明 |
|---|---|
| ra_Code | 响应码（100=成功） |
| ra_Status | 交易状态（100=成功） |
| rb_CodeMsg | 响应描述 |
| r2_OrderNo | 商户订单号 |
| r7_TrxNo | 平台交易流水号 |
| hmac | 签名 |
100 且 ra_Status=100| 项目 | 内容 |
|---|---|
| 接口名称 | 关闭订单 |
| 请求方式 | HTTP POST (form-urlencoded) |
| 接口路径 | /tradeRt/closeOrder |
| 完整测试URL | https://trade.joinpay.cc/tradeRt/closeOrder |
| p0_Version | 1.0 |
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| p0_Version | 是 | 接口版本，固定 1.0 | 1.0 |
| p1_MerchantNo | 是 | 商户号 | 888100500008456 |
| p2_OrderNo | 是 | 商户订单号 | ORDER20260413001 |
| p3_FrpCode | 是 | 原支付交易类型 | WEIXIN_NATIVE |
| hmac | 是 | 签名 | — |
| 条件 | 能否关单 | 说明 |
|---|---|---|
| 订单状态=NOTPAY | ✅ 可以 | 未支付的超时订单可以关单 |
| 订单状态=SUCCESS | ❌ 不行 | 已支付的订单不能关单，只能退款 |
| 订单状态=CLOSED | ❌ 不行 | 已关闭的订单重复关单会返回错误 |
| 订单状态=FAILED | ❌ 不行 | 失败的订单无需关单 |
最佳实践：建议在下单后 30分钟 内轮询订单状态，若仍为 NOTPAY 则调用关单接口释放库存。
[P1] 此接口响应为 JSON 格式，不是 form 格式！
如果按 form 格式解析 JSON 响应会导致所有字段值为
null。 解析策略：检查响应正文首个非空白字符是否为{，若是则用 JSON 解析器处理。
| 参数 | 说明 |
|---|---|
| ra_Code | 响应码（100=成功） |
| rb_CodeMsg | 响应描述 |
| hmac | 签名 |
| 项目 | 内容 |
|---|---|
| 接口名称 | 资金管控订单查询 |
| 请求方式 | HTTP POST (form-urlencoded) |
| 接口路径 | /tradeRt/queryFundsControlOrder |
| 完整测试URL | https://trade.joinpay.cc/tradeRt/queryFundsControlOrder |
| p0_Version | 1.0 |
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| p0_Version | 是 | 接口版本，固定 1.0 | 1.0 |
| p1_MerchantNo | 是 | 商户号 | 888100500008456 |
| p2_OrderNo | 是 | 商户订单号 | ORDER20260413001 |
| hmac | 是 | 签名 | — |
| 参数 | 说明 |
|---|---|
| ra_Code | 响应码（100=成功） |
| rb_CodeMsg | 响应描述 |
| rc_Result | 资金管控详情 |
| hmac | 签名 |
| 文件 | 内容 |
|---|---|
| 订单状态流转.md | 订单状态定义、关单规则 |
| 错误码.md | TOP 20 错误码速查 |
| 响应码完整列表.md | 完整响应码（含退款专用） |
| 基础支付常见问题.md | 20 个 FAQ |
| signing-rules.md | 签名规则 |
汇聚支付（JoinPay）完整接入技能包总入口。用于在单个 Skill 导入环境中承载聚合支付、二级商户入网、分账方入网与结算、延迟分账、多次分账、共享签名协议、异步通知、示例代码和接入治理资料。触发词：汇聚支付接入、JoinPay接入、聚合支付、二级商户入网、分账方入网、分账方结算、延迟分账、多次分账、secondaryMch、altmch、altSettle、altHandle。
汇聚支付聚合支付基础 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、发布检查、共享基础资料。