Biarkan AI agent membayar dengan OKXdan mendaftar sendiri

Bayar dengan OKX Wallet melalui x402 dan dapatkan API key serta saldo dalam satu permintaan.

USD₮0 di X Layer, diselesaikan melalui OKX
Tanpa kartu kredit dan tanpa formulir pendaftaran
Pengguna biasa juga dapat mengisi saldo dengan x402

Minta pendaftaran tanpa membayar. Respons 402 menjelaskan yang diterima server.

Permintaan

curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","amountUsd":1.1}'

Contoh responsData contoh

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

Apa itu x402

POST/api/v1/agents/register/x402
← 402accepts[ network, asset, amount, payTo ]
signEIP-3009
POSTX-PAYMENT: …
← 201api_key, credits, claim_token

Pembayaran diselesaikan melalui x402 facilitator OKX di X Layer secara on-chain; server memeriksa setiap pembayaran sebelum bertindak.

HTTP 402 meminta pembayaran

Server menjawab dengan 402 dan mencantumkan jaringan, aset, jumlah, serta alamat tujuan yang diterima. Klien menandatangani otorisasi pembayaran lalu mengirim permintaan yang sama lagi. BazaarLink menyelesaikan setiap pembayaran melalui x402 facilitator OKX di X Layer.

api_keysk-bl-…

credits5

claim_token…

payment.txHash0x…

Tidak perlu akun terlebih dahulu

Agent tidak perlu mengisi formulir atau membuat akun sebelumnya. Permintaan yang membawa pembayaran membuat akun, menerbitkan API key, dan menambahkan saldo.

/register

Empat langkah dari permintaan ke API key

Kirim permintaan

POST ke /api/v1/agents/register/x402 dengan nama dan jumlah dalam dolar AS yang ingin dibayar.

Terima 402

Server membalas 402 dengan persyaratan pembayaran. Belum ada apa pun yang dibuat pada tahap ini.

Tandatangani dan kirim ulang

Tandatangani otorisasi pembayaran dengan wallet sendiri, masukkan ke header X-PAYMENT, lalu kirim permintaan yang sama lagi.

Dapatkan API key

Setelah pembayaran dikonfirmasi, Anda menerima 201 berisi API key, saldo, dan tautan klaim. API key hanya muncul dalam respons ini, jadi segera simpan.

/topup

Sudah punya akun? Isi saldo dengan x402 juga

Agent memakai API key yang sudah dimiliki. Pengguna biasa masuk lalu mengisi saldo dari halaman kredit.

Agent dan skrip

POST ke /api/x402/topup dengan header Authorization dan amountUsd. Alurnya sama seperti pendaftaran: kutip, tanda tangani, kirim ulang.

Pengguna biasa

Masuk, buka halaman kredit, pilih x402, lalu tandatangani pembayaran dengan wallet browser.

/network

Jaringan dan aset yang didukung

Saat ini satu kombinasi yang didukung.

Jaringan: X Layer, diselesaikan melalui x402 facilitator OKX
Aset: USD₮0
Saldo: Berlaku biaya isi saldo platform, sehingga saldo yang masuk lebih rendah dari jumlah yang dibayar (lihat harga)
Jumlah per pembayaran: Ada batas minimum dan maksimum; batas saat ini ditampilkan dalam respons 402 dan GET /api/x402/topup

Pembayaran on-chain tidak dapat dibatalkan. Periksa jumlah dan jaringan sebelum menandatangani.

Belum membayar? Model gratis tetap dapat digunakan

Akun agent yang belum membayar memakai kuota model gratis dan batas laju yang sudah ada (auto:free). Setelah membayar, akun mengikuti aturan normal akun berbayar.

/faq

Pertanyaan umum

Apa itu x402?

x402 adalah protokol yang memakai kode status HTTP 402 untuk meminta pembayaran. Server menyatakan jumlah, jaringan, dan alamat tujuan; klien menandatangani otorisasi pembayaran lalu mengirim permintaan yang sama lagi.

Apa yang diperlukan untuk membayar dengan x402?

OKX Wallet, atau kunci wallet apa pun yang dapat menandatangani otorisasi EIP-3009, serta USD₮0 di X Layer. Dokumentasi integrasi berisi kode TypeScript yang memakai klien x402 untuk penandatanganan.

Jaringan dan aset apa yang didukung?

USD₮0 di X Layer, diselesaikan melalui x402 facilitator OKX. Berlaku biaya isi saldo platform, sehingga saldo yang Anda terima lebih rendah dari jumlah yang dibayar; lihat halaman harga.

Apa yang terjadi jika saya membayar atau mengirim ulang dua kali?

Setiap pembayaran dikreditkan sekali. Mengirim ulang pembayaran yang sama saat mengisi saldo mengembalikan already_credited. Untuk pendaftaran, hasil yang sama dikembalikan selama 15 menit; setelah itu Anda mendapat already_registered dan API key tidak ditampilkan lagi.

Bisakah saya mendapat pengembalian dana?

Pembayaran on-chain tidak dapat dibatalkan dan sistem tidak mengembalikan dana secara otomatis. Hubungi dukungan jika terjadi masalah.

Apakah ada batas pendaftaran?

Ada. Pendaftaran dari sumber jaringan yang sama dibatasi dalam waktu singkat. Saat mencapai batas, Anda mendapat 429 dengan header Retry-After; tunggu lalu coba lagi.

Bisakah seseorang mengambil alih akun agent?

Bisa. Respons pendaftaran berisi claim_token dan upgrade_url. Seseorang masuk dan mengklaim akun; API key dan saldo berpindah ke akunnya. claim_expires menunjukkan batas waktunya.

Biarkan agent Anda
mengurus pembayarannya sendiri

Baca dokumentasi integrasi

Tersalin