Huifu DouGong Aggregation Refund
by @codecodeing
汇付支付聚合支付退款的斗拱SDK Skill：覆盖聚合交易退款和退款结果查询。参数表和业务规则按协议字段组织，Java SDK 调用方式放在语言适配入口里。当开发者需要对聚合支付订单发起退款或查询退款状态时使用。触发词：聚合退款、聚合退款申请、聚合退款查询、聚合退款状态。
clawhub install huifu-dougong-aggregation-refund📖 About This Skill
name: huifu-dougong-aggregation-refund display_name: 汇付支付聚合支付退款 description: "汇付支付聚合支付退款的斗拱SDK Skill：覆盖聚合交易退款和退款结果查询。参数表和业务规则按协议字段组织，Java SDK 调用方式放在语言适配入口里。当开发者需要对聚合支付订单发起退款或查询退款状态时使用。触发词：聚合退款、聚合退款申请、聚合退款查询、聚合退款状态。" version: 1.1.0 author: "jiaxiang.li | 内容版权：上海汇付支付有限公司" homepage: https://paas.huifu.com/open/home/index.html license: CC-BY-NC-4.0 compatibility: - openclaw dependencies: - huifu-dougong-aggregation-base metadata: openclaw: requires: config: - HUIFU_PRODUCT_ID - HUIFU_SYS_ID - HUIFU_RSA_PRIVATE_KEY - HUIFU_RSA_PUBLIC_KEY - HUIFU_REFUND_NOTIFY_URL
> 版权声明：本 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 前先确认：原交易定位键已经在订单侧沉淀，退款请求也按 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天 |
注意事项
1. 退款金额不能超过原交易金额（延时交易退款金额须≤待确认金额）
2. resp_code=00000000 或 00000100 仅表示退款请求已受理
3. 退款最终结果以异步通知或退款查询接口为准
4. 退款成功后资金原路返回给用户
5. 退款为异步处理，请做好幂等校验
6. 原交易定位键为 org_hf_seq_id、org_party_order_id、org_req_seq_id 三选一
7. remark、notify_url、tx_metadata 通常通过 client.optional() 或 request.optional() 传入
8. 退款查询使用的是退款标识：org_hf_seq_id、退款 org_req_seq_id、mer_ord_id 三选一；传退款全局流水号时 org_req_date 可不传
9. 退款涉及资金变动，日志中记录关键参数但避免打印完整密钥
流水号关系
退款涉及三层流水号，需清楚关联关系：
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