← 返回 Skills 市场

Huifu DouGong Aggregation Refund

Name: Huifu DouGong Aggregation Refund
Author: codecodeing

作者青衫墨痕 · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

310

总下载

当前安装

版本数

在 OpenClaw 中安装

/install huifu-dougong-aggregation-refund

功能描述

汇付支付聚合支付退款的斗拱SDK Skill：覆盖聚合交易退款和退款结果查询。参数表和业务规则按协议字段组织，Java SDK 调用方式放在语言适配入口里。当开发者需要对聚合支付订单发起退款或查询退款状态时使用。触发词：聚合退款、聚合退款申请、聚合退款查询、聚合退款状态。

使用说明 (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

安全使用建议

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.

功能分析

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.

能力标签

cryptocan-make-purchases

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install huifu-dougong-aggregation-refund
安装完成后，直接呼叫该 Skill 的名称或使用 /huifu-dougong-aggregation-refund 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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

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.

元数据

Slug huifu-dougong-aggregation-refund

版本 1.0.2

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 3

常见问题