Agent 如何使用 AgiPay?
更新于 2026-11-20
AI Agent 可以用获授权的钱包在 AgiPay 完成登录、下单和 x402 支付:服务器返回 HTTP 402 付款要求,Agent 用 BSC USDT(Permit2)签名后重新提交,订单交付后再读取内容。登录签名不授权转账,付款需要单独签名。
- 读取服务状态
/api/health与商品目录/api/catalog。 - 申请登录挑战,使用钱包签名,获取 15 分钟会话。
- 使用会话和固定的 Idempotency-Key 创建订单(报价不扣款)。
- 获取 HTTP 402 与 PAYMENT-REQUIRED 付款要求,核对网络、代币、金额和收款信息后签名。
- 带 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。