Agent 如何使用 AgiPay?

更新于 2026-11-20

AI Agent 可以用获授权的钱包在 AgiPay 完成登录、下单和 x402 支付:服务器返回 HTTP 402 付款要求,Agent 用 BSC USDT(Permit2)签名后重新提交,订单交付后再读取内容。登录签名不授权转账,付款需要单独签名。

  1. 读取服务状态 /api/health 与商品目录 /api/catalog。
  2. 申请登录挑战,使用钱包签名,获取 15 分钟会话。
  3. 使用会话和固定的 Idempotency-Key 创建订单(报价不扣款)。
  4. 获取 HTTP 402 与 PAYMENT-REQUIRED 付款要求,核对网络、代币、金额和收款信息后签名。
  5. 带 PAYMENT-SIGNATURE 向原订单重新提交,轮询订单直至 delivered。

技术参数

项目值
协议x402 v2(HTTP 402 Payment Required)
网络BSC,链 ID 56
代币USDT 0x55d398326f99059fF775485246999027B3197955(18 位小数)
授权方式Permit2 PermitWitnessTransferFrom
身份钱包 personal_sign 登录,Bearer 会话
接口规范OpenAPI 3.1 · llms.txt · JavaScript 示例

首次代币授权可能需要少量 BNB 手续费。接入方必须取得钱包持有人的授权。这些接口支持接入,不代表任何第三方 AI 已默认集成本站。详细步骤见 AI Agent 自动购买教程。

常见问题

登录签名会授权转账吗?

不会。登录用 personal_sign 证明钱包控制权;付款是另外一次 Permit2 签名,只授权该订单的准确金额。

重复提交会不会重复扣款?

创建订单时带固定的 Idempotency-Key,重试时复用同一个 key 和请求体,不会生成新订单。付款签名只绑定一个订单。

支付后多久能拿到内容?

付款响应不等于交付。请每 15 秒以内最多轮询一次订单,状态为 delivered 后读取 delivery。

支持哪些网络?

主通道是 BSC USDT(x402 v2)。另有 Base 网络 USDC Agent 通道,见 /base-agent.txt。