AI 集成概述
AI Checkout 接口允许您构建能够编排加密货币支付的 AI Agent（聊天机器人、Copilot 或自主智能体）。
架构与职责
集成 AI Checkout 时，您实际上是在构建一个 Agent 运行时（Agent Runtime），它充当 用户钱包 与 GStable API 之间的桥梁。
与我们托管 UI 的标准结账流程不同，在 AI 支付中，您负责构建 Agent 的“身体”和“大脑”，而我们提供底层 “支付逻辑”和“结算通道”。
职责矩阵
| 功能板块 | 谁来构建？ | 描述 |
|---|---|---|
| 用户界面 (UI) | 您 (开发者) | 聊天窗口、连接钱包按钮以及交易确认卡片。 |
| Agent 运行时 | 您 (开发者) | 后端或客户端逻辑，负责调用 API、解析响应并构造 EIP-712 消息。 |
| 钱包连接 | 您 (开发者) | 集成 wagmi、ethers.js 或 viem 等库，以请求用户签名。 |
| 支付逻辑 | GStable SaaS | 验证商品、计算价格、处理跨链路由以及生成交易调用数据 (Calldata)。 |
| 资金结算 | GStable SaaS | 监控链上事件并将资金结算至您的商户账户。 |
交互时序图
下图展示了您的 Agent 运行时如何协调用户与 GStable API 之间的交互。
集成核心概念
1. "AI View" (AI 视图)
我们的 API 会返回一个专为 LLM 设计的 aiView 对象。它包含：
- 语义 (Semantics)：商品是什么（去除 HTML 格式）。
- 工作流 (Workflow)：Agent 下一步该做什么（例如，“询问用户地址”或“请求签名”）。
- 授权规范 (AuthorizationSpec)：如何构造供用户签名的 EIP-712 消息。
2. EIP-712 签名
我们使用 EIP-712 处理所有涉及状态变更的操作。这确保了 Agent 无法在没有用户钱包明确、可读授权的情况下动用用户资金或创建订单。
您需要在运行时中使用标准的 Web3 库来实现签名处理程序。
下一步
准备好开始构建了吗？请前往 集成工作流 指南查看以代码为核心的教程。