版权声明：本 Skill 内容来源于上海汇付支付有限公司官方开放平台文档，版权归属上海汇付支付有限公司。如有疑问可咨询汇付支付客服：400-820-2819 / cs@huifu.com
Source: Official Open Platform documentation of Shanghai Huifu Payment Co., Ltd.
Copyright: Shanghai Huifu Payment Co., Ltd.
聚合支付 - 查询、关单与对账
交易查询 + 交易关单 + 关单查询 + 对账单查询。
适配版本与复核信息
| 项目 | 内容 |
|---|---|
| Skill 版本 | 1.1.0 |
| 当前适配 SDK | dg-lightning-sdk 1.0.3 |
| 最后复核日期 | 2026-04-08 |
| 官方文档来源 | 汇付开放平台聚合支付查询/关单/对账接口文档、Java SDK 文档、异步消息说明 |
运行依赖与凭据边界
本 Skill 依赖 huifu-dougong-aggregation-base 提供公共运行时。凭据使用规则与存放边界见 credential-boundary.md。
前置依赖：首次接入请先阅读 huifu-dougong-aggregation-base 完成 SDK 初始化。
进入本 Skill 前先确认：上游下单侧已经保存
req_date、req_seq_id、hf_seq_id、party_order_id等查询键；具体来源和客户准备项见 customer-preparation.md。
官方开发指引补充约束：微信 / 支付宝 / 银联多个渠道文档都明确要求，用户前端页面收到支付完成回调后，后端仍需调用查询订单 API 确认最终状态。
协议规则入口
语言适配入口
这份 Skill 的查询字段、关单限制和对账字段，都是语言无关的。
具体语言怎么初始化和发请求，先看这里：
触发词
- "聚合交易查询"、"聚合订单查询"、"聚合订单状态"、"查询聚合支付结果"
- "聚合关单"、"聚合交易关闭"、"关闭聚合订单"
- "聚合关单查询"、"关单状态"
- "对账单"、"对账"、"账单查询"、"结算对账"
场景路由
| 用户意图 | 场景 | 详细说明 |
|---|---|---|
| 查询订单支付状态 | 聚合交易查询 | 见 payment-query.md |
| 关闭未支付订单 | 聚合交易关单 | 见 trade-close.md |
| 查询关单结果 | 关单查询 | 见 close-query.md |
| 查询对账单 | 对账单查询 | 见 reconciliation.md |
使用场景说明
交易查询
- 用户支付后未收到异步通知，需主动确认支付结果
- 收到异步通知后做二次确认
- 反扫支付返回处理中（用户需输入密码），轮询确认
- 当
trans_stat=P时，建议间隔 5 秒轮询，最多 30 次（150 秒）
交易关单
- 用户长时间未支付，主动关闭订单释放资源
- 仅支持微信和支付宝交易，银联/数字货币不支持
- 原交易已是终态（成功/失败）的，关单会失败
- 不允许关闭一分钟以内的订单
关单查询
- 发起关单请求后未收到结果，查询关单状态
对账单查询
- 查询交易/结算/分账/出金/用户结算等对账文件
- 接口支持 1 年内账单下载；控台下载当前口径暂未限制时间范围
- 对账文件按 T+1/D+1 规则生成；最新产品介绍口径建议交易/分账文件
12:00后下载，出金对账单10:30跑批后一小时，结算对账单17:00跑批后一小时 - 每天建议不超过 3 次查询
- 请求字段名固定为
file_date和bill_type；不要按中文释义改写成bill_date、generate_date或file_type
注意事项
- 查询需要传入
huifu_id，并使用out_ord_id、hf_seq_id、req_seq_id三选一作为查询键；req_date为条件必填，建议在按req_seq_id查询时一并传入 - 关单需要传入
req_date、req_seq_id、huifu_id、org_req_date，并在org_hf_seq_id、org_req_seq_id中二选一定位原交易 - 关单查询需要传入
req_date、req_seq_id、huifu_id、org_req_date，并在org_hf_seq_id、org_req_seq_id中二选一；且只能通过原交易查询关单状态 - 关单后用户将无法再对该订单进行支付
- 已支付成功的订单无法关单，只能走退款流程
- 银联二维码交易不支持关单
- 建议收到异步通知后仍调用查询接口做二次确认
- 常规对账单下载结果通常是压缩文件，压缩包内多为 csv；
SETTLE_FUND_BILL模板为.xlsx，不要把所有账单都按 csv 解析 - 对账单查询请求参数应直接使用
file_date和bill_type，不要额外设计bill_date/generate_date -> file_date或file_type -> bill_type映射层
快速接入代码示例见 quickstart.md。
版权声明与联系方式见 copyright-notice.md