Ada satu masalah. Endpoint yang menentukan cara dibayar, dan endpoint x402 yang ditemui agent biasanya meminta USDC di jaringan tertentu, seperti Base atau Solana. Agent Anda mungkin memegang hal lain: USDT di Solana, USDC di Stellar, atau USDT di BNB Chain. Bridge sebelum setiap panggilan juga tidak bisa, karena persyaratan pembayaran x402 hanya berlaku beberapa menit, dan memindahkan uang antar chain biasanya butuh waktu lebih lama dari itu.
ROZO independen dan tidak berafiliasi dengan penjual x402 mana pun.
Isi saldo sekali, bayar berkali-kali
x402 payer dari ROZO membagi masalah ini menjadi dua. Anda mengisi saldo ROZO sekali saja, dengan koin yang sudah Anda punya, di chain yang sudah Anda pakai. Setelah itu, setiap panggilan x402 ke endpoint yang menerima USDC di Base dibayar dari saldo itu dalam hitungan detik, di dalam batas waktu pembayaran.
Kalau agent Anda bisa menjalankan perintah shell, inilah seluruh integrasinya:
- Isi saldo sekali. Perintah ini menampilkan alamat deposit sekali pakai; bayar dari wallet Anda sendiri: npx @rozoai/checkout x402 topup 20 --with usdt-solana
- Panggil endpoint berbayar. CLI membaca 402, ROZO menandatangani, dan request dikirim lagi bersama pembayarannya: npx @rozoai/checkout x402 pay https://api.example.com/v1/search --method POST --body '{"q":"..."}'
- Lihat sisa saldo: npx @rozoai/checkout x402 balance
Apa yang terjadi saat x402 pay
Mesin Anda mengirim request langsung ke endpoint. Saat 402 kembali, CLI membaca persyaratan pembayaran, hanya menyimpan opsi USDC di Base, lalu meminta ROZO menandatangani satu pembayaran itu. Setelah itu CLI mengirim ulang request asli Anda dengan header PAYMENT-SIGNATURE dan menampilkan responsnya.
Setiap pembayaran membawa idempotencyKey, dan percobaan ulang pembayaran itu memakai key yang sama, jadi timeout tidak bisa menagih Anda dua kali.
Tidak ada shell? Pembayaran yang sama berjalan lewat dua endpoint HTTP inti, /v1/x402/topup dan /v1/x402/sign, dengan agent key Anda sebagai bearer token. Agent Anda mengirim ulang request-nya sendiri dengan tanda tangan itu. Halaman x402 menampilkan kedua panggilan tersebut.
Yang melindungi uang Anda
Memberi agent sebuah wallet adalah risiko nyata, jadi payer ini dibangun dengan izin yang sempit.
- Key hanya bisa membelanjakan saldo. Top up pertama membuat agent key yang diawali ak_. Key ini bisa membayar dari saldo ROZO Anda dan tidak bisa yang lain. Key ini tidak pernah menyentuh wallet Anda sendiri, ROZO tidak pernah memegang key wallet Anda, dan ROZO hanya menyimpan hash dari agent key.
- Setiap pembayaran punya batas. Secara default satu pembayaran maksimal $5 dan satu key bisa membelanjakan paling banyak $100 per hari. Keduanya adalah nilai default dan bisa diatur per key. Anda juga bisa membatasi key ke daftar alamat payTo, dan CLI menolak setiap pembayaran di atas batas yang Anda tetapkan dengan --max-usd.
- Pembayaran sekali jalan, bukan langganan. Setiap panggilan butuh 402 baru dari penjual dan tanda tangan baru dari ROZO. Penjual tidak pernah mendapat izin tetap untuk menarik dana lagi nanti.
- Request Anda tetap milik Anda. Request berbayar berjalan dari mesin Anda ke endpoint. ROZO tidak pernah melihat isi request, header Anda, atau API key yang Anda pakai untuk layanan itu. ROZO hanya melihat persyaratan pembayaran yang diminta untuk ditandatangani: siapa yang dibayar, berapa, dan di jaringan mana.
Bisa isi saldo pakai apa, dan apa yang dibayarkan
Ada dua jalur, dan sengaja ditampilkan terpisah.
Jalur top up, dari Anda ke ROZO:
- USDT di Solana, BNB Chain, Ethereum atau Polygon
- USDC di Solana, BNB Chain, Ethereum, Polygon, Base atau Stellar
Punya koin native atau sats? Anda bisa memakainya untuk top up OpenRouter lewat ROZO Checkout di checkout.rozo.ai.
Jalur pembayaran, dari ROZO ke penjual x402:
- Base (eip155:8453): USDC, skema x402 exact
- Solana: menyusul nanti
Penjual selalu dibayar dalam USDC, karena pembayaran x402 exact adalah transfer token. USDT hanya untuk mengisi saldo; penjual dibayar dalam USDC. Jika sebuah endpoint hanya menerima USDC di Solana, CLI berhenti dengan X402_UNSUPPORTED sebelum ada yang ditagih.
Top up minimum $5, dan top up dikenai biaya 1%. Setiap pembayaran x402 dari saldo hanya sebesar yang diminta penjual. Penarikan saldo belum bisa dilakukan sendiri: kirim email ke hi@rozo.ai dengan key Anda yang disamarkan dan jumlahnya, lalu saldo dikirim kembali di chain pilihan Anda.
Mulai sekarang
Payer ini sudah aktif sekarang. Halaman checkout.rozo.ai/x402 memuat tiga perintah, panggilan HTTP, batas, dan FAQ dalam satu tempat. Referensi lengkap, termasuk semua kode error, ada di docs.rozo.ai. Agent bisa membaca instruksi yang sama, lengkap dengan aturan keamanan dan panduan percobaan ulang, di checkout.rozo.ai/llms.txt dan di repositori RozoAI/rozo-checkout-skill di GitHub.
Isi saldo sekali dengan koin yang Anda punya, lalu biarkan agent Anda membayar sendiri API yang dipanggilnya.