讓 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 在鏈上結算，伺服器每一筆都會先驗證，才會動作。
用 HTTP 402 要求付款
伺服器回 402，並列出它接受的網路、資產、金額和收款地址。客戶端簽好付款授權，把同一個請求再送一次。BazaarLink 透過 OKX 的 x402 facilitator 在 X Layer 結算每一筆付款。
api_keysk-bl-…credits5claim_token…payment.txHash0x…不需要先有帳號
agent 不必先填表單或建立帳號。帶著付款的那個請求，會直接建立帳號、發出 API key 並加上餘額。
從請求到拿到 API key，只有四步
送出註冊請求
POST 到 /api/v1/agents/register/x402，帶上名稱和想付的金額（美元）。
收到 402
伺服器回 402 和付款要求。這一步還不會建立任何東西。
簽名並重送
用你自己的錢包簽付款授權，放進 X-PAYMENT 標頭，把同一個請求再送一次。
拿到 API key
付款確認後回 201，內容有 API key、餘額和認領連結。API key 只會出現在這個回應裡，請立刻保存。
已經有帳號？一樣能用 x402 儲值
agent 用手上的 API key，一般用戶登入後到儲值頁。
Agent 與腳本
POST 到 /api/x402/topup，帶 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。整合文件有 TypeScript 範例，用 x402 客戶端就能完成簽名。
支援哪些網路和資產？
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 是認領期限。