前言¶
接汇付（斗拱）支付时，常见难点不在「会不会调 HTTP」，而在字段是否对齐官方 DTO、签名验签、异步通知与支付终态、幂等与查单补偿，以及沙箱联调与上线后的通道排查。文档分散在 SDK 与接口说明里，问通用大模型又容易漏渠道差异或编造错误码。
下面介绍 SkillHub 上的 汇付支付集成（@user_93f1fdbc/huifu-pay-integration，v1.4.0）。它由 上海汇付支付有限公司 以 enterprise 来源发布，分类为 dev-programming，标签 requires_api_key=false，用于在 Agent 对话里按官方能力边界协助交易接入与排障，而不是替代商户密钥与生产配置。
这是什么¶
汇付支付集成 面向汇付支付 / 斗拱支付（Huifu Payment）的 交易接入与开发排障：聚合支付、托管支付、余额支付、checkout-js 与各端收银台，以及 Java / PHP / Python 官方 SDK、完整字段与 DTO、签名验签、异步通知与 Webhook、幂等、支付终态、查单补偿、本地沙箱与上线排查。
商户 进件、开户、资料维护、费率或业务开通 不在本 Skill 范围内，应使用 huifu-merchant-onboarding。若单次任务既要开户开通又要支付联调，需要 同时启用两个 Skill，端到端请求才能对齐官方分工。
核心功能¶
以下能力均来自 SkillHub 页面简介，按接入链路归纳。
支付产品与收银¶
- 聚合支付、托管支付、余额支付
checkout-js与各端收银台
渠道与交易类型¶
- 渠道：微信、支付宝、银联、抖音等
- 交易：预下单 / 下单、查单、关单、退款、合单、拆单 / 分账查询、对账
余额与辅助接口¶
- 余额手续费试算
- 付款关系提交
- 短信验证码
工程与稳定性¶
- Java / PHP / Python 官方 SDK，完整字段 / DTO
- 签名验签
- 异步通知 / Webhook
- 幂等、支付终态、查单补偿
- 本地沙箱与上线排查
安装与启用¶
SkillHub 官方页面给出的安装方式，是让 AI 按统一安装文档处理坐标包，而不是手写业务代码。
方式一：提示词安装（页面推荐）¶
将下面提示发给当前使用的 AI Agent：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_93f1fdbc/huifu-pay-integration`。
方式二：SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时 必须 使用 --dir 指向当前 Agent 的 skills 目录；装到默认 ./skills/ 可能不会被识别。常见路径如下（以安装文档为准）：
| Agent | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装本 Skill 示例：
skillhub install @user_93f1fdbc/huifu-pay-integration --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你当前环境对应目录即可。Codex、Claude Code 等同理，仅路径不同。
典型用法¶
本 Skill 基于通用 SKILL.md 格式，页面未附带独立业务代码仓库；典型用法是在已安装的前提下，用自然语言描述场景，让 Agent 按汇付官方 SDK 与接口约束生成或校对实现。
- 预下单 / 下单：说明渠道（如微信、支付宝）、收银形态（聚合、托管或收银台）、金额与商户单号，要求对照 DTO 字段与签名规则组请求。
- 异步通知：描述 Webhook 或异步通知处理逻辑草案，要求验签、幂等更新订单、区分支付终态，并说明重复回调时的处理。
- 查单与补偿：支付结果不明时，要求走查单接口并与本地订单状态对齐，必要时给出查单补偿步骤。
- 退款 / 合单 / 分账：说明原交易信息与分账规则，要求覆盖关单、退款、拆单 / 分账查询与对账相关接口。
- 联调与上线：区分沙箱与生产配置，列出签名、密钥与通道类问题的排查顺序（不输出真实密钥）。
若对话涉及 开户、进件、业务开通，应显式切换到 huifu-merchant-onboarding，或与本 Skill 联用。
适用场景与注意¶
适合谁
- 正在接入斗拱 / 汇付支付的后端或全栈开发者
- 需要统一对照 Java / PHP / Python SDK、DTO 与签名验签的团队
- 处理异步通知、幂等、终态与查单补偿的维护人员
限制与注意
requires_api_key=false表示 Skill 元数据不强制绑定 API Key；生产商户号、密钥、证书仍由你在安全环境中配置，勿写入对话或仓库明文。- 进件与支付能力拆分在两个 Skill；不要指望单一 Skill 覆盖开户到收款全链路。
- 页面统计（截至资料抓取）：评分 100000，下载 8377；以 SkillHub 实时页面为准。
- 版本以 SkillHub 为准，当前为 v1.4.0。
结尾¶
汇付支付集成 把斗拱交易接入、SDK/DTO、签名验签、异步通知与排障知识收敛到 Agent 可执行的 Skill 里，并与 huifu-merchant-onboarding 在职责上划清边界。需要安装或查看说明时，可打开官方地址：
- API 页：https://api.skillhub.cn/user_93f1fdbc/huifu-pay-integration
- SkillHub 页：https://www.skillhub.cn/skills/user_93f1fdbc/huifu-pay-integration
