用你手上的幣支付任何 x402 API
x402 端點會回傳 402 Payment Required，要求以 USDC 付款。ROZO 支付的是要求 Base 上 USDC 的端點。你的 agent 手上可能是其他鏈上的其他幣。先用手上的幣為 ROZO 餘額儲值一次，之後每次 x402 呼叫都從餘額秒付。
三個指令
只要你的 agent 能執行 shell 指令，這就是全部的串接。
Shell
# 1. 儲值一次。顯示一次性收款地址，從你自己的錢包付款。 npx @rozoai/checkout x402 topup 20 --with usdt-solana # 2. 呼叫付費端點。讀取 402，由 ROZO 簽章，帶著付款憑證重新送出請求。 npx @rozoai/checkout x402 pay https://api.example.com/v1/search --method POST --body '{"q":"..."}' # 3. 查看剩餘餘額。 npx @rozoai/checkout x402 balance
x402 pay 做了什麼
- 請求由你的電腦直接送往端點。ROZO 看不到請求內容、你的標頭，也看不到你在該服務使用的 API 金鑰。
- 收到 402 後，CLI 讀取付款要求，只保留 Base 上的 USDC，超過
--max-usd（預設 1.00）一律拒絕。 - 以新產生的
idempotencyKey請 ROZO 簽署一筆付款。重試沿用同一把 key，即使逾時也不會重複扣款。 - 帶上
PAYMENT-SIGNATURE標頭重新送出原請求，並輸出回應內容。
原始 HTTP：兩次呼叫
沒有 shell？直接呼叫同一套 API。agent 金鑰放在 Authorization: Bearer ak_...。
HTTP
# 儲值：回傳所選幣種的一次性收款地址。 curl -s -X POST https://apiserver.mpprouter.dev/v1/x402/topup \ -H 'authorization: Bearer ak_...' -H 'content-type: application/json' \ -d '{"amount":"20","token":"USDT","chain":"900"}' # 簽章：傳入你從 402 的 "accepts" 清單中選定的那一筆。 # 回傳 PAYMENT-SIGNATURE 標頭的值，帶著它重新送出你的請求。 curl -s -X POST https://apiserver.mpprouter.dev/v1/x402/sign \ -H 'authorization: Bearer ak_...' -H 'content-type: application/json' \ -d '{"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x...","maxTimeoutSeconds":60}],"budget":"0.05","idempotencyKey":"<uuid>"}'
POST /v1/x402/keys 建立 agent 金鑰（只顯示一次）。GET /v1/x402/balance 查詢餘額。同一筆付款的每次重試都使用同一個 idempotencyKey。
可以用什麼儲值，最後付出去的是什麼
兩段刻意分開列出：你付給 ROZO 的，以及賣家收到的。
儲值段（你付給 ROZO）
| 幣種 | 鏈 |
|---|---|
| USDT | Solana, BNB Chain, Ethereum, Polygon |
| USDC | Solana, BNB Chain, Ethereum, Polygon, Base, Stellar |
付款段（ROZO 付給 x402 賣家）
| 網路 | 資產 | x402 方案 |
|---|---|---|
Base eip155:8453 | USDC | exact |
| Solana | 稍後支援。只接受 Solana USDC 的端點會在扣款前被拒絕。 | |
儲值接受 USDC 和 USDT。賣家收到的永遠是 USDC，因為 x402
exact 付款是代幣轉帳；以 USDT 儲值的餘額，由 ROZO 以 USDC 支付賣家。手上是原生幣或聰（sats）？可以用 ROZO Checkout 為 OpenRouter 儲值。額度與金鑰
- 單筆：預設最多 $5。每日：預設最多 $100。也可以把金鑰限定為只付給指定的
payTo地址。 - 最低儲值：$5。儲值收取 1% 手續費；之後每筆 x402 付款只扣賣家要求的金額。
- Agent 金鑰：第一次儲值會建立以
ak_開頭的金鑰，只顯示一次，CLI 會存到~/.rozo-checkout/x402-key，僅本人可讀取。ROZO 只保存它的雜湊值。 - 金鑰就代表餘額的所有權。不要貼到提示詞、紀錄或客服單。遺失時請建立新的，並聯絡我們轉移餘額。
常見問題
為什麼要先儲值？
x402 的付款要求只有一到五分鐘的有效期，跨鏈轉帳則需要更久。只有從已經到位的餘額付款，才能在這段時間內完成。儲值次數少、金額大；付款次數多、金額小。
我的錢在哪裡？
在你的 ROZO x402 餘額裡。資金存放在 ROZO 的錢包，由 Base 上的錢包代你的金鑰簽署付款，所有餘額總額每小時與這些錢包對帳一次。ROZO 從不持有你自己錢包的私鑰。
要怎麼把餘額領回來？
目前還不能自助提領。請把遮罩後的金鑰（例如 ak_...a1b2）和金額寄到 hi@rozo.ai，我們會在你指定的鏈上退回。
ROZO 看得到我的請求嗎？
看不到。付費請求從你的電腦直接送往端點。ROZO 只看得到被要求簽署的那筆付款要求：付給誰、多少錢、在哪個網路。
賣家可以在哪些網路收款？
Base 上的 USDC（eip155:8453），x402 方案 exact。Solana 付款段稍後支援。如果端點只接受 Solana，CLI 會以 X402_UNSUPPORTED 停止，不會扣任何款項。