Bayar API x402 apa pun dengan koin yang sudah kamu punya

Endpoint x402 menjawab 402 Payment Required dan meminta USDC. ROZO membayar endpoint yang meminta USDC di Base. Agen kamu mungkin memegang koin lain di jaringan lain. Isi saldo ROZO sekali dengan koin yang ada, lalu setiap panggilan x402 berikutnya dibayar dari saldo itu dalam hitungan detik.

Tiga perintah

Kalau agen kamu bisa menjalankan perintah shell, inilah seluruh integrasinya.

# 1. Isi saldo sekali. Menampilkan alamat setoran sekali pakai; bayar dari dompet kamu sendiri.
npx @rozoai/checkout x402 topup 20 --with usdt-solana

# 2. Panggil endpoint berbayar. Membaca 402, ROZO menandatangani, permintaan dikirim ulang dengan pembayaran.
npx @rozoai/checkout x402 pay https://api.example.com/v1/search --method POST --body '{"q":"..."}'

# 3. Lihat sisa saldo.
npx @rozoai/checkout x402 balance

Apa yang terjadi pada x402 pay

HTTP mentah: dua panggilan

Tidak ada shell? Pakai API yang sama secara langsung. Kirim agent key sebagai Authorization: Bearer ak_....

# Isi saldo: mengembalikan alamat setoran sekali pakai untuk koin pilihanmu.
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"}'

# Tanda tangan: kirim satu syarat yang kamu pilih dari daftar "accepts" di respons 402.
# Mengembalikan nilai header PAYMENT-SIGNATURE. Kirim ulang permintaanmu dengannya.
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 membuat agent key (ditampilkan sekali). GET /v1/x402/balance mengembalikan saldo. Gunakan idempotencyKey yang sama untuk setiap percobaan ulang satu pembayaran.

Isi saldo dengan apa, dan apa yang dibayarkan

Dua sisi sengaja dipisah: yang kamu kirim ke ROZO, dan yang diterima penjual.

Sisi isi saldo (kamu ke ROZO)

Sisi pembayaran (ROZO ke penjual x402)

Batas dan key kamu

• Per pembayaran: maksimal $5 secara default. Per hari: maksimal $100 secara default. Key juga bisa dibatasi ke daftar alamat payTo.
• Isi saldo minimum: $5. Isi saldo dikenai biaya 1%; setiap pembayaran x402 sesudahnya hanya sebesar yang diminta penjual.
• Agent key: isi saldo pertama membuat key yang diawali ak_. Key ditampilkan sekali dan CLI menyimpannya di ~/.rozo-checkout/x402-key dengan izin hanya untuk pemilik. ROZO hanya menyimpan hash-nya.
• Key adalah pemilik saldo. Jangan tempel ke prompt, log, atau tiket. Kalau hilang, buat yang baru dan hubungi kami untuk memindahkan saldo.

Tanya jawab

Kenapa harus isi saldo dulu?

Syarat pembayaran x402 hanya berlaku satu sampai lima menit, sedangkan memindahkan dana antar jaringan butuh waktu lebih lama. Membayar dari saldo yang sudah siap adalah satu satunya cara menjawab dalam rentang itu. Isi saldo jarang dan besar; bayar sering dan kecil.

Di mana uang saya?

Di saldo x402 ROZO kamu. Dana disimpan di dompet ROZO, dompet di Base yang menandatangani pembayaran untuk key kamu, dan total semua saldo dicocokkan dengan dompet itu setiap jam. ROZO tidak pernah memegang kunci dompet kamu sendiri.

Bagaimana cara menarik saldo?

Penarikan mandiri belum tersedia. Kirim email ke hi@rozo.ai berisi key yang disamarkan (misalnya ak_...a1b2) dan jumlahnya, lalu kami kirim kembali di jaringan pilihanmu.

Apakah ROZO melihat permintaan saya?

Tidak. Permintaan berbayar dikirim dari mesin kamu langsung ke endpoint. ROZO hanya melihat syarat pembayaran yang diminta untuk ditandatangani: siapa yang dibayar, berapa, dan di jaringan apa.

Di jaringan apa penjual dibayar?

USDC di Base (eip155:8453), skema x402 exact. Pembayaran di Solana menyusul. Kalau endpoint hanya menerima Solana, CLI berhenti dengan X402_UNSUPPORTED dan tidak ada yang ditagih.