AI 辅助对接
您可以将本文档提供给 AI 编程工具（例如 Claude、ChatGPT、Cursor、GitHub Copilot），让它协助生成对接代码。本页提供可直接供 AI 读取的文档文件。
下载文档文件
本文档只能从白名单 IP 打开，AI 工具无法直接读取网页地址，请先下载文件再提供给 AI。
| 文件 | 内容 | 适用场景 |
|---|---|---|
| llms-full.txt | 所有页面合并成的单个 Markdown 文件 | 大多数情况请使用此文件，一次性向 AI 提供完整规则 |
| llms.txt | 文档目录与各页摘要 | AI 工具的上下文长度有限、只想提供目录时 |
每一页也有对应的 Markdown 版本，将地址中的 .html 换成 .md 即可获取，例如代收建单的 Markdown 版本位于 /zh-cn/api/collect.md。
文档更新后请重新下载，以免 AI 按旧版规则生成代码。
提供给 AI 的方式
| 工具类型 | 做法 |
|---|---|
| 对话界面（Claude、ChatGPT 等） | 将 llms-full.txt 作为附件上传，再说明需要它做什么。 |
| 编程工具（Claude Code、Cursor、GitHub Copilot 等） | 将 llms-full.txt 放入您的项目，例如 docs/qpay-api.md，在对话中引用该文件（例如 @docs/qpay-api.md）。之后每次让 AI 修改对接代码时都可以重复引用。 |
不要把机密数据提供给 AI
- 不要把生产环境的 API 验证密钥粘贴到对话中或上传给 AI。请让 AI 从环境变量或配置文件读取密钥，测试时使用签名示例中的示例凭证或测试环境凭证。
- 不要把真实订单、付款人姓名、收款账号等数据粘贴给 AI。
验证 AI 生成的代码
AI 可能误解规则或自行假设，请不要直接将生成的代码用于生产环境：