AI Agent 自动购买教程:从签名登录到 x402 结算

更新于 2026-11-20

结论:AI Agent 只需要一个获授权的 BSC 钱包,就能按「检查状态 → 签名登录 → 创建订单 → 处理 402 → Permit2 签名付款 → 轮询交付」六步,在 AgiPay 自动买到数字服务。下面是每一步要调用的接口和注意事项。

准备

第 1 步:检查服务

GET /api/health,确认 paymentReady=true;GET /api/catalog 读取商品,GET /api/products/{productId}/checkout-options 选择可用 SKU。

第 2 步:钱包签名登录

POST /api/auth/challenge 提交钱包地址,对返回的消息做 personal_sign,再 POST /api/auth/session 换取 15 分钟会话令牌。之后所有订单接口都带 Authorization: Bearer。

第 3 步:幂等创建订单

POST /api/orders,请求体 {"productId":…,"skuId":…},带 16–100 位的 Idempotency-Key。重试时复用同一个 key,创建报价不会扣款。

第 4 步:获取付款要求

POST /api/orders/{id}/pay 返回 HTTP 402,PAYMENT-REQUIRED 头里有准确的 USDT 金额、收款地址和资源标识。先和预期收款地址、花费上限比对。

第 5 步:Permit2 签名并提交

必要时先给 Permit2 授权准确金额,然后按 Permit2 域签 PermitWitnessTransferFrom(witness 为收款地址),把 x402 v2 JSON base64 后放进 PAYMENT-SIGNATURE 头,重新请求同一个付款接口。

第 6 步:轮询交付

GET /api/orders/{id},每 15 秒以内最多一次,直到 state=delivered 再读取 delivery。状态为 confirming_payment、awaiting_procurement、payment_review 或 needs_attention 时不要重新付款,保留订单号对账。

常见错误

完整字段见 OpenAPI 与 llms.txt;协议原理见 x402 指南。

常见问题

Agent 需要我的主钱包私钥吗?

不需要,也不建议。给 Agent 单独的钱包,只放必要余额,并设置花费上限。

一个钱包能给多个 Agent 用吗?

可以,但订单都归属同一个钱包身份。不同 Agent 用不同钱包会被视为不同身份。

可以先测试不付款吗?

可以。读取目录、登录、创建订单和获取 402 报价都不会扣款,只有提交付款签名才会结算。