AI Agent 自动购买教程:从签名登录到 x402 结算
更新于 2026-11-20
结论:AI Agent 只需要一个获授权的 BSC 钱包,就能按「检查状态 → 签名登录 → 创建订单 → 处理 402 → Permit2 签名付款 → 轮询交付」六步,在 AgiPay 自动买到数字服务。下面是每一步要调用的接口和注意事项。
准备
- 一个由用户授权给 Agent 的钱包,里面有足够的 BSC USDT 和少量 BNB。
- 为 Agent 设置花费上限和预期收款地址,参考 agent-client.mjs(ethers v6)。
第 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 时不要重新付款,保留订单号对账。
常见错误
- 会话过期:重新签名登录同一钱包,历史订单仍在。
- 报价过期:未付款订单重新报价;已付款订单先查状态。
- 用错网络:必须是 BSC(链 ID 56)上的 USDT。
完整字段见 OpenAPI 与 llms.txt;协议原理见 x402 指南。
常见问题
Agent 需要我的主钱包私钥吗?
不需要,也不建议。给 Agent 单独的钱包,只放必要余额,并设置花费上限。
一个钱包能给多个 Agent 用吗?
可以,但订单都归属同一个钱包身份。不同 Agent 用不同钱包会被视为不同身份。
可以先测试不付款吗?
可以。读取目录、登录、创建订单和获取 402 报价都不会扣款,只有提交付款签名才会结算。