让 AI agent 用 OKX 付款自主完成注册
通过 OKX Wallet 使用 x402 付款，一次请求即可获得 API key 和余额。
- X Layer上的 USD₮0，经 OKX 结算
- 无需信用卡，也无需填写注册表单
- 普通用户也能用x402充值
curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
-H "Content-Type: application/json" \
-d '{"name":"my-agent","amountUsd":1.1}'HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"resource": {
"url": "https://bazaarlink.ai/api/v1/agents/register/x402",
"description": "BazaarLink paid agent registration",
"mimeType": "application/json"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:196",
"payTo": "0xPAY_TO_ADDRESS",
"asset": "0xASSET_CONTRACT",
"amount": "1100000",
"maxTimeoutSeconds": 300,
"extra": { "name": "USD₮0", "version": "1" }
}
]
}什么是x402
- POST
/api/v1/agents/register/x402 - ← 402
accepts[ network, asset, amount, payTo ] - sign
EIP-3009 - POST
X-PAYMENT: … - ← 201
api_key, credits, claim_token
付款通过 OKX 的 x402 facilitator 在 X Layer 结算；服务器会先检查每一笔付款，再执行操作。
HTTP 402请求付款
服务器返回402，并列出接受的网络、资产、金额和收款地址。客户端签署付款授权，再次发送同一个请求。BazaarLink 通过 OKX 的 x402 facilitator 在 X Layer 结算每笔付款。
api_keysk-bl-…credits5claim_token…payment.txHash0x…无需先创建账户
agent不用提前填写表单或创建账户。携带付款的请求会创建账户、发放API key并增加余额。
从请求到API key的四步流程
发送请求
向 /api/v1/agents/register/x402 发起POST请求，带上名称和要支付的美元金额。
收到402
服务器返回402和付款要求。此时不会创建任何内容。
签名并重发
用自己的钱包签署付款授权，将它放入X-PAYMENT请求头，再次发送同一个请求。
获得API key
付款确认后会收到201，其中包含API key、余额和认领链接。API key只会在这次响应中出现，请立即保存。
已经有账户？也可以用x402充值
agent使用已有的API key；普通用户登录后从充值页面操作。
Agent和脚本
向 /api/x402/topup 发起POST请求，带上Authorization请求头和amountUsd。流程与注册相同：询价、签名、重发。
普通用户
登录后打开充值页面并选择x402，再用浏览器钱包签署付款。
支持的网络和资产
目前只支持一种组合。
- 网络
- X Layer，经 OKX 的 x402 facilitator 结算
- 资产
- USD₮0
- 余额换算
- 充值时会收取平台充值手续费，入账余额会低于实际付款金额（详见价格说明）
- 每笔金额
- 有最低和最高金额；当前限制见402响应和GET /api/x402/topup
链上付款无法撤回。签名前请确认金额和网络。
还没付款？免费模型仍可使用
尚未付款的agent账户继续使用现有的免费模型额度和速率限制（auto:free）。付款后，账户遵循付费账户的常规规则。
常见问题
什么是x402？
x402是一种使用HTTP 402状态码请求付款的协议。服务器说明金额、网络和收款地址；客户端签署付款授权，再次发送同一个请求。
使用x402付款需要什么？
OKX Wallet，或任何能签署 EIP-3009 授权的钱包密钥，以及 X Layer 上的 USD₮0。集成文档包含使用 x402 客户端签名的 TypeScript 代码。
支持哪些网络和资产？
X Layer 上的 USD₮0，经 OKX 的 x402 facilitator 结算。充值时会收取平台充值手续费，入账余额会低于付款金额，详见价格说明。
重复付款或重发会怎样？
每笔付款只入账一次。充值时重发同一笔付款会返回already_credited。注册在15分钟内返回相同结果；之后会返回already_registered，且不会再次显示API key。
可以退款吗？
链上付款无法撤回，系统也不会自动退款。如果出现问题，请联系客服。
注册次数有限制吗？
有。同一网络来源在短时间内的注册次数有限。达到限制后会返回429和Retry-After请求头；请等待后再试。
真人可以接管agent账户吗？
可以。注册响应包含claim_token和upgrade_url。真人登录并认领账户后，API key和余额会转到其账户；claim_expires表示认领期限。