← Back to Skills Marketplace
codecodeing

Huifu DouGong Aggregation Query

by 青衫墨痕 · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
299
Downloads
3
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install huifu-dougong-aggregation-query
Description
汇付支付聚合支付查询与关单的斗拱SDK Skill：覆盖聚合交易查询、聚合交易关单、关单查询、对账单查询。参数表和业务规则按协议字段组织，Java SDK 调用方式放在语言适配入口里。当开发者需要查询聚合支付订单状态或关闭未支付的聚合订单时使用。触发词：聚合交易查询、聚合订单查询、聚合关单、聚合交易关闭、对账单。
README (SKILL.md)

版权声明：本 Skill 内容来源于上海汇付支付有限公司官方开放平台文档，版权归属上海汇付支付有限公司。如有疑问可咨询汇付支付客服：400-820-2819 / [email protected]

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

注意事项

  1. 查询需要传入 huifu_id，并使用 out_ord_id、hf_seq_id、req_seq_id 三选一作为查询键；req_date 为条件必填，建议在按 req_seq_id 查询时一并传入
  2. 关单需要传入 req_date、req_seq_id、huifu_id、org_req_date，并在 org_hf_seq_id、org_req_seq_id 中二选一定位原交易
  3. 关单查询需要传入 req_date、req_seq_id、huifu_id、org_req_date，并在 org_hf_seq_id、org_req_seq_id 中二选一；且只能通过原交易查询关单状态
  4. 关单后用户将无法再对该订单进行支付
  5. 已支付成功的订单无法关单，只能走退款流程
  6. 银联二维码交易不支持关单
  7. 建议收到异步通知后仍调用查询接口做二次确认
  8. 常规对账单下载结果通常是压缩文件，压缩包内多为 csv；SETTLE_FUND_BILL 模板为 .xlsx，不要把所有账单都按 csv 解析
  9. 对账单查询请求参数应直接使用 file_date 和 bill_type，不要额外设计 bill_date/generate_date -> file_date 或 file_type -> bill_type 映射层

快速接入代码示例见 quickstart.md。

版权声明与联系方式见 copyright-notice.md

Usage Guidance
This skill appears to be documentation-based glue for Huifu's aggregation query/close/reconciliation APIs and legitimately needs the merchant IDs and an RSA keypair to sign API requests. Before installing: (1) Verify the skill source/trustworthiness (source is listed as unknown; homepage points to Huifu). (2) Only provide test or scoped credentials (not your production private key) until you confirm behavior. Store keys in a secure vault and grant least privilege. (3) Review the upstream dependency huifu-dougong-aggregation-base (the skill references it) — ensure it is trustworthy. (4) If you do not want autonomous calls that could sign requests with your key, restrict agent/skill invocation or require explicit confirmation before network calls. If you want higher assurance, request the skill author or Huifu-signed source code or perform an internal code review of the base SDK.
Capability Analysis
Type: OpenClaw Skill Name: huifu-dougong-aggregation-query Version: 1.0.2 The skill bundle provides documentation and instructions for an AI agent to interact with the Huifu (汇付支付) payment platform for querying transaction statuses, closing orders, and retrieving reconciliation files. The content consists of API specifications, parameter mappings for the 'dg-lightning-sdk', and Java code snippets for manual HTTP requests to official Huifu endpoints (e.g., api.huifu.com). There is no evidence of malicious intent, data exfiltration, or prompt injection; the required sensitive configuration (RSA keys) is standard for payment gateway integrations.
Capability Tags
cryptocan-make-purchases
Capability Assessment
✓ Purpose & Capability
Name/description (Huifu aggregation query/close/reconciliation) match the artifacts and required config: product/sys IDs and an RSA keypair are reasonable for signing requests to Huifu's APIs. Declared dependency on a base aggregation SDK is expected.
✓ Instruction Scope
SKILL.md is documentation-style runtime instructions (how to build requests, sign with RSA, call Huifu endpoints, parse returned download_url). It does not instruct reading unrelated system files or exfiltrating data to third-party endpoints beyond Huifu. The code snippets explicitly sign requests and POST to Huifu endpoints, which is within scope.
✓ Install Mechanism
Instruction-only skill with no install spec and no bundled code — lowest-risk install model. All runtime behavior is described in docs rather than arbitrary downloaded code.
✓ Credentials
Required config items (HUIFU_PRODUCT_ID, HUIFU_SYS_ID, HUIFU_RSA_PRIVATE_KEY, HUIFU_RSA_PUBLIC_KEY) are expected for a payment SDK because requests must be signed and identify the merchant. These are sensitive (private key) but justified by the skill purpose; no unrelated secrets or broad credentials are requested.
ℹ Persistence & Privilege
Skill is not forced always-on (always:false) and is user-invocable. Model invocation is allowed (normal). Note: granting an agent access to a merchant RSA private key increases blast radius if the agent is allowed to invoke the skill autonomously; this is a policy decision for the user, not an incoherence in the skill.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install huifu-dougong-aggregation-query
  3. After installation, invoke the skill by name or use /huifu-dougong-aggregation-query
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Skill 名称由 "dougong-aggregation-aggregate-query" 改为 "huifu-dougong-aggregation-query"，display name 相应更新。 - 依赖包由 "dougong-aggregation-pay-base" 替换为 "huifu-dougong-aggregation-base"。 - 文档中所有相关依赖、链路和引用路径替换为新的依赖包命名方式（huifu-前缀）。 - 版权声明和其他基础信息保持不变，业务能力未做调整。
v1.0.1
Version 1.1.0 introduces structure and compliance improvements: - Updated license to CC-BY-NC-4.0. - Added protocol rules and SDK version/last review tracking. - Clarified credential boundary and dependency links. - Reorganized parameter and rule info by protocol fields. - Moved code usage guidance to language adaptation entry points. - Compressed copyright/contact details into shared documentation.
v1.0.0
- Initial release of 汇付聚合支付查询关单与对账 Skill (version 1.0.0) - Supports querying aggregate pay order status, closing unpaid orders, querying close status, and downloading reconciliation statements - Provides trigger words for common user intents (order query, close order, check close status, reconciliation statement) - Lists required dependencies and configuration for integration - Includes important usage notes, required parameters, and scenarios for each function - Guidance and documentation sourced from Shanghai Huifu Payment Co., Ltd. official API documentation
Metadata
Slug huifu-dougong-aggregation-query
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Huifu DouGong Aggregation Query?

汇付支付聚合支付查询与关单的斗拱SDK Skill：覆盖聚合交易查询、聚合交易关单、关单查询、对账单查询。参数表和业务规则按协议字段组织，Java SDK 调用方式放在语言适配入口里。当开发者需要查询聚合支付订单状态或关闭未支付的聚合订单时使用。触发词：聚合交易查询、聚合订单查询、聚合关单、聚合交易关闭、对账单。 It is an AI Agent Skill for Claude Code / OpenClaw, with 299 downloads so far.

How do I install Huifu DouGong Aggregation Query?

Run "/install huifu-dougong-aggregation-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Huifu DouGong Aggregation Query free?

Yes, Huifu DouGong Aggregation Query is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Huifu DouGong Aggregation Query support?

Huifu DouGong Aggregation Query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Huifu DouGong Aggregation Query?

It is built and maintained by 青衫墨痕 (@codecodeing); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments