宝付聚合 Skills 使用指引

本文面向接入宝付聚合接口的商户与研发人员，说明如何使用Skills技能包（skills/baofu-juhe-api/）快速完成宝付聚合支付产品对接。

接口的权威定义（字段必填、错误码、支付方式、测试/生产环境地址等）始终以官网为准；
可编译 DEMO 请从官方文档页的 聚合支付 DEMO 下载（含 JAVA / .NET / PHP 等版本）获取，实际参数以对应产品接口文档为准。
Skills 用于对齐报文格式、签名规则与工程实践。

一、Skills 技能包下载

二、 目录说明

Skills 文档（供 AI 工具加载或人工阅读）：

skills/baofu-juhe-api/
├── SKILL.md           # 技术说明（主文档）
├── reference.md       # 附录与备忘

测试环境证书（与 Skills 同仓库时，位于cer/内，用于测试环境联调）：

cer/                   
├── BAOFU20240612_pri.pfx   # 测试环境私钥
├── BAOFUP20240612_pub.cer    # 测试环境公钥

将 baofu-juhe-api 目录加入 Cursor 等工具的 Skills 即可；证书路径在 DEMO 或自有工程中配置为指向 cer/（相对路径以运行目录为准）。生产环境请替换为贵司正式证书。

三、如何在 AI 工具中使用本 Skills

1. 在 Cursor 等工具中，将 baofu-juhe-api 目录加入 Skills（或按工具说明导入 Skills）。
2. 在对话中直接用自然语言描述对接需求，AI 会结合 SKILL.md 中的规则实现接口对接。示例：
   • 对接宝付支付宝主扫接口
   • 对接一下查询接口
   • 对接一下退款接口
3. 请同时打开 聚合类产品官方文档，核对字段必填与附录中的支付方式枚举；Skills 不替代官网。