← 返回使用指南
API 接入
用 AI 通用对接文档完成接入
获取完整文档，向 AI 说明技术栈与业务目标，再按接口和回调逐项验收。
图文步骤
按步骤在自己的后台操作，点击图片可放大查看。
从后台顶部 API 文档进入开发者中心，点击左侧 AI 通用对接文档。使用“复制完整文档”或“下载 Markdown”，将完整内容粘贴或作为文件交给你使用的 AI 编程助手；不要只截取某一个接口示例。
第 1 步 · 点击图片放大 告诉 AI 你的后端语言、框架与版本、现有订单表、需要接入的收款或代付流程，以及回调路由。要求先列出改动计划和字段映射，再生成代码；不清楚的字段应先向你确认，不能自行编造接口。
让 AI 按文档实现商户 UID + API Key 配置、HMAC-SHA256 请求签名、创建与查询订单、回调验签和幂等处理。金额用字符串与精确计算类型；请求签名与回调签名是两种不同格式，不能混用。
优先复用文档中提供的 Node.js 或 PHP / Laravel SDK；其他技术栈按同一签名规范实现。让 AI 同时输出环境变量模板、安装步骤和测试；示例中的 UID、金额与地址都需要按自己的业务填写。
只向 AI 提供公开文档、占位符配置和脱敏报错。真实 API Key 由你在运行环境中配置为 UUGATE_API_KEY，不粘贴到聊天、前端代码或仓库。让 AI 用本地虚构测试密钥验证签名、原始回调体和重复通知处理。
先阅读“接口下单与查单调试”和“回调接收与接口调试”。用官方工具与生成代码对照同一业务请求的参数和结果；通过后检查异常分支、持久化幂等与自身回调服务，再接入真实业务。AI 生成完成不等于对接验收完成。
这里的“对接 AI”是将 UUGate 文档交给 AI 编程助手生成你自己系统的接入代码，不需要把支付密钥交给 AI，也不需要新增 AI 专用支付接口。
可交给 AI 的任务说明（替换方括号内容）
请以我提供的 UUGate AI 通用对接文档为唯一接口规格，为 [后端语言 / 框架 / 版本] 项目接入 [收款 / 独享钱包 / 单笔代付]。
先列出业务流程、订单字段映射、回调路由和需要确认的问题，再编写代码。
配置从环境变量读取：UUGATE_BASE_URL、UUGATE_MERCHANT_UID、UUGATE_API_KEY；此处只使用占位符，不询问或输出真实密钥。
实现请求签名、创建/查询订单、保留 rawBody 的回调验签、数据库事务和唯一约束防止重复入账，并核对商户、订单、币种、金额与终态。
提供安装说明、环境变量模板、正常/篡改/重复回调测试和常见错误排查。不得自动请求生产下单或付款接口。