CartAI

1) 选择您的 CartAI 集成模式: 根据您的产品界面选择使用 CartAI 的方式：(a) API（在您的应用程序中完全控制），(b) MCP 服务器（将 CartAI 工具插入到 Claude Desktop/Code/Cursor/VS Code 等 MCP 主机中），或 (c) 托管购物车（用于从未有过结账功能的界面的嵌入式结账组件/iframe）。

2) 获取访问权限和 API 密钥: 创建 CartAI 访问权限并获取用于身份验证请求的 API 密钥。在调用 CartAI 端点时，您将使用此密钥作为授权标头中的 Bearer 令牌。

3) 确定您要完成的交易工作流: 确定您希望 CartAI 完成的确切交易（例如，电子商务结账、订阅注册、发票支付、订单提交）。收集目标 URL 和任何必需的输入（变体选择、配送详情、支付详情、如果适用则为登录要求）。

4) 准备客户身份字段: 创建您将传递给 CartAI 的客户对象（例如，电子邮件和姓名）。这用于将工作流与买家/客户上下文关联起来。

5) 准备配送和支付配置文件: 创建配送地址和支付方式的结构化配置文件。在此示例中，这些文件被引用为“./buyer.json”（配送配置文件）和“./card.json”（支付配置文件）。CartAI 支持符合 PCI 标准的卡片输入/存储和令牌化支付处理。

6) 创建结账任务负载: 定义一个或多个任务。每个任务包括：(a) 目标：要进行交易的网页 URL，(b) 变体：任何产品选项（例如，颜色），(c) 配送：配送配置文件引用，以及 (d) 支付：支付配置文件引用。任务是可组合的，可以根据流程进行调整（有些可能不需要配送或支付）。

7) 在沙盒模式下启动（推荐）: 在测试时设置 options.sandbox = true。这使您可以在投入生产之前验证负载结构和工作流行为。

8) 调用 CartAI 结账 API: 向 https://api.cartai.ai/checkout 发送 POST 请求，标头为 Content-Type: application/json 和 Authorization: Bearer <YOUR_CARTAI_KEY>。在 JSON 正文中包含您的客户、任务和选项。

9) 示例请求（来自 CartAI 官方网站）: POST https://api.cartai.ai/checkout，JSON 正文如下：{ customer: { email: "[email protected]", name: "Jane Doe" }, tasks: [{ target: "bestbuy.com/site/sony-wh-1000xm5/6505727.p", variant: { color: "black" }, shipping: { profile: "./buyer.json" }, payment: { profile: "./card.json" } }], options: { sandbox: true } }

10) 捕获异步响应（taskId + 状态）: CartAI 异步执行。即时响应返回一个 taskId（例如，“task_abc123”）和一个状态（例如，“queued”）。存储 taskId 以进行跟踪。

11) 通过 Webhook 跟踪执行直到完成: 监听 Webhook 事件以获取状态转换，直到工作流完成。CartAI 为每个状态转换提供 Webhook，以便您可以更新 UI、触发下游操作并确认交易何时完成。

12) 安全处理重试（幂等设计）: 如果您的系统需要重试请求（网络故障、超时），请使用 CartAI 的幂等、重试安全方法，以免意外重复交易。

13) 从沙盒迁移到生产环境: 一旦您的工作流在沙盒中可靠地完成，请切换到生产设置（禁用沙盒），并确保您的 Webhook 处理、日志记录和客户支持流程已为真实订单/支付做好准备。

14) (替代方案) 通过 AI 主机中的 MCP 服务器使用 CartAI: 如果您希望代理直接从兼容 MCP 的环境中运行结账，请安装并连接 CartAI MCP 服务器。这会将 CartAI 目录、支付和结账 API 作为工具暴露给 Claude Desktop/Code、Cursor 或 VS Code 等主机，从而实现产品搜索、成本估算、支付授权和具有状态跟踪的自主结账。

15) (替代方案) 使用托管购物车进行嵌入式结账: 如果您要将结账功能添加到从未有过结账功能的界面（例如，编辑页面、推荐源），请将 CartAI 托管购物车作为嵌入式组件/iframe 嵌入。它包括变体选择、地址收集、支付和确认，由相同的底层 CartAI 交易基元提供支持。