← Back to Skills Marketplace
310
Downloads
3
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install huifu-dougong-aggregation-refund
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 前先确认：原交易定位键已经在订单侧沉淀，退款请求也按 payload-construction.md 做过必填 / 条件必填校验，避免把缺少原交易标识的请求直接打到汇付。
协议规则入口
语言适配入口
这份 Skill 的退款字段、定位键和状态说明，都是语言无关的。
具体语言怎么初始化和发请求，先看这里：
触发词
- "聚合退款"、"聚合退款申请"、"聚合交易退款"
- "聚合退款查询"、"聚合退款状态"、"查询聚合退款结果"
场景路由
| 用户意图 | 场景 | 详细说明 |
|---|---|---|
| 对已支付订单发起退款 | 交易退款 | 见 refund.md |
| 查询退款结果 | 退款结果查询 | 见 refund-query.md |
退款流程
1. 确认原交易已支付成功（trans_stat=S）
2. 调用退款接口 v4/trade/payment/scanpay/refund
3. 退款 resp_code=00000100（处理中）是正常的
4. 等待异步通知或轮询退款查询接口
5. 退款成功（trans_stat=S）后执行业务退款逻辑
退款期限
| 渠道 | 最大退款期限 |
|---|---|
| 微信 | 360天 |
| 支付宝 | 360天 |
| 银联二维码 | 360天 |
注意事项
- 退款金额不能超过原交易金额（延时交易退款金额须≤待确认金额）
resp_code=00000000或00000100仅表示退款请求已受理- 退款最终结果以异步通知或退款查询接口为准
- 退款成功后资金原路返回给用户
- 退款为异步处理，请做好幂等校验
- 原交易定位键为
org_hf_seq_id、org_party_order_id、org_req_seq_id三选一 remark、notify_url、tx_metadata通常通过client.optional()或request.optional()传入- 退款查询使用的是退款标识：
org_hf_seq_id、退款org_req_seq_id、mer_ord_id三选一；传退款全局流水号时org_req_date可不传 - 退款涉及资金变动，日志中记录关键参数但避免打印完整密钥
流水号关系
退款涉及三层流水号，需清楚关联关系：
1. 原交易下单: req_seq_id = "A001"（原支付流水号）
2. 退款请求: req_seq_id = "B001"（退款流水号），org_req_seq_id = "A001"
3. 退款查询: org_req_seq_id = "B001"（查的是退款的流水号）
org_hf_seq_id = 退款返回的 hf_seq_id（也可以用这个查）
快速接入代码示例见 quickstart.md。
版权声明与联系方式见 copyright-notice.md
Usage Guidance
This skill appears coherent for integrating Huifu refund APIs. Before installing: 1) Confirm the referenced base skill (huifu-dougong-aggregation-base) is trustworthy because it performs SDK init and may perform network calls; 2) Provision HUIFU_RSA_PRIVATE_KEY and other config values in a secure vault (do not store them in plain text); 3) Ensure your refund notify_url points to an endpoint you control and that the agent will not leak private keys in logs; 4) Verify the homepage/contact details (paas.huifu.com and the provided support channels) match your expectations; 5) Because the skill is instruction-only, there is no code to inspect beyond the docs — if you need stronger assurance, ask the publisher for a published package or signed SDK and inspect the base-skill implementation.
Capability Analysis
Type: OpenClaw Skill
Name: huifu-dougong-aggregation-refund
Version: 1.0.2
The skill bundle provides documentation and instructions for an AI agent to perform payment refunds and status queries via the Huifu (汇付支付) platform. It defines clear API mappings for the 'dg-lightning-sdk', specifies required configuration for RSA keys and IDs, and includes detailed protocol rules for signing and notifications. No evidence of malicious intent, data exfiltration, or harmful prompt injection was found; all instructions are strictly aligned with the legitimate purpose of payment processing.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (Huifu aggregation refund) align with what the skill asks for: product_id, sys_id, RSA keys and a notify_url are typical and required for calling Huifu refund/refund-query APIs and producing signatures.
Instruction Scope
SKILL.md restricts actions to refund and refund-query protocol, SDK usage, and integration notes; it does not instruct reading unrelated system files or exfiltrating data. It references a base skill for initialization — review that base skill before use.
Install Mechanism
No install spec and no code files are present (instruction-only), so nothing is downloaded or written to disk by the skill itself.
Credentials
The skill requests access to HUIFU_PRODUCT_ID, HUIFU_SYS_ID, HUIFU_RSA_PRIVATE_KEY, HUIFU_RSA_PUBLIC_KEY, and HUIFU_REFUND_NOTIFY_URL (declared as config paths). These are proportionate to a payment integration, but HUIFU_RSA_PRIVATE_KEY is highly sensitive — ensure it is provisioned securely and not exposed to logs or other skills.
Persistence & Privilege
always is false and the skill is user-invocable; it does not request permanent presence or claim ability to modify other skills. Autonomous invocation is allowed (platform default) and appropriate for an integration skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install huifu-dougong-aggregation-refund - After installation, invoke the skill by name or use
/huifu-dougong-aggregation-refund - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Skill名称由“dougong-aggregation-aggregate-refund”更新为“huifu-dougong-aggregation-refund”，display_name/描述也相应更新为“汇付支付聚合支付退款”。
- 依赖由“dougong-aggregation-pay-base”调整为“huifu-dougong-aggregation-base”。
- 各文档/协议/凭据链接路径均由“dougong-aggregation-*”“dougong-pay-shared-base”更换为“huifu-dougong-aggregation-*”“huifu-dougong-pay-shared-base”。
- 其他功能、用户体验及业务规则未做更改。
v1.0.1
汇付聚合支付退款 Skill 1.1.0 版本更新：
- 补充适配版本、复核信息与官方文档引用，提升合规性说明。
- 明确依赖凭据存放边界，增加凭据使用规范指引。
- 参数表、业务规则按协议字段组织，技术说明更加结构化。
- Java SDK 调用方式迁移至通用语言适配入口，强调 Skill 语言无关性。
- License 由 MIT 调整为 CC-BY-NC-4.0，版权声明引用外部文件。
v1.0.0
- Initial release of the 汇付聚合支付退款 (Huifu Aggregation Payment Refund) skill.
- Supports initiating refunds and querying refund status for aggregation payment orders.
- Includes detailed usage instructions, credential requirements, and dependency on dougong-aggregation-pay-base.
- Provides quick start guide, trigger words, refund process, and important operational notes.
- Documentation sourced directly from Shanghai Huifu Payment Co., Ltd. official platform.
Metadata
Frequently Asked Questions
What is Huifu DouGong Aggregation Refund?
汇付支付聚合支付退款的斗拱SDK Skill：覆盖聚合交易退款和退款结果查询。参数表和业务规则按协议字段组织，Java SDK 调用方式放在语言适配入口里。当开发者需要对聚合支付订单发起退款或查询退款状态时使用。触发词：聚合退款、聚合退款申请、聚合退款查询、聚合退款状态。 It is an AI Agent Skill for Claude Code / OpenClaw, with 310 downloads so far.
How do I install Huifu DouGong Aggregation Refund?
Run "/install huifu-dougong-aggregation-refund" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Huifu DouGong Aggregation Refund free?
Yes, Huifu DouGong Aggregation Refund is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Huifu DouGong Aggregation Refund support?
Huifu DouGong Aggregation Refund is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Huifu DouGong Aggregation Refund?
It is built and maintained by 青衫墨痕 (@codecodeing); the current version is v1.0.2.
More Skills