TransX402 Docs

Apa itu x402?

Penjelasan lengkap tentang protokol x402 — bagaimana HTTP 402 memungkinkan pembayaran otomatis menggunakan stablecoin langsung di web.

Sekilas

  • Server merespons request dengan HTTP 402 Payment Required beserta syarat pembayaran yang dapat dibaca mesin
  • Wallet pembeli menandatangani otorisasi pembayaran — tanpa gas
  • Sebuah fasilitator (seperti TransX402) memverifikasi tanda tangan lalu mengirim transaksi on-chain

Latar Belakang

Kode status HTTP 402 Payment Required sudah ada sejak spesifikasi HTTP/1.1 pertama di tahun 1997, tetapi belum pernah digunakan secara luas — hingga sekarang. x402 adalah protokol pembayaran terbuka yang dikembangkan Coinbase dan didukung Cloudflare, yang akhirnya memanfaatkannya: menyematkan instruksi pembayaran yang dapat dibaca mesin ke dalam respons HTTP standar, memungkinkan pembayaran stablecoin instan dan otomatis langsung di web.

Bagaimana Pembayaran Bekerja

Client mengirim request. Client (browser, aplikasi, atau AI agent) mengirim request HTTP biasa, misalnya untuk mengakses artikel premium:

GET /artikel/premium-content HTTP/1.1
Host: example.com

Server merespons dengan 402. Jika konten membutuhkan pembayaran, server merespons dengan detail pembayaran dalam JSON:

{
  "x402Version": 1,
  "accepts": [{
    "scheme": "permit2",
    "network": "base",
    "token": "0x18Bc5bcC660cf2B9cE3cd51a404aFe1a0cBD3C22",
    "maxAmountRequired": "5000000000000000000000",
    "resource": "https://example.com/artikel/premium-content"
  }]
}

Client menandatangani otorisasi pembayaran. Pembeli menandatangani otorisasi kriptografi gasless — tanpa membutuhkan ETH. Untuk token Permit2 seperti IDRX, approval satu kali diperlukan terlebih dahulu; setiap pembayaran setelahnya hanya butuh tanda tangan. Payload bertanda tangan dikirim ke fasilitator untuk verifikasi.

Fasilitator memverifikasi dan mengirim on-chain. TransX402 memverifikasi tanda tangan, memeriksa saldo pembayar, mensimulasikan transaksi, lalu mengirimkannya ke blockchain — dan membayar gas-nya sendiri.

Blockchain mengonfirmasi transaksi. Settlement on-chain selesai dan fasilitator menerima konfirmasi bahwa pembayaran berhasil.

Fasilitator memberitahu server. Setelah settlement, fasilitator memberi tahu server bahwa pembayaran valid sehingga konten yang dilindungi bisa dirilis.

Server mengirimkan konten. Server mengembalikan 200 OK normal beserta konten yang diminta (dan header X-PAYMENT-RESPONSE jika berlaku).

Metode Otorisasi

x402 mendukung beberapa metode otorisasi pembayaran. IDRX menggunakan Permit2, karena merupakan token ERC-20 standar tanpa dukungan EIP-3009 bawaan.

MetodeTokenKeterangan
EIP-3009USDC, EURCNative gasless transfer — paling sederhana
Permit2Semua ERC-20 (termasuk IDRX)Approval satu kali ke kontrak Permit2
ERC-7710Smart contract walletsUntuk wallet kontrak pintar

Mengapa Biaya Transaksi Bisa Serendah Ini?

Biaya tetap di bawah Rp 50 per transaksi karena tiga hal yang bekerja bersama: settlement L2 yang murah, tanda tangan off-chain gratis, dan satu transaksi teroptimasi yang dibayar oleh fasilitator.

  • Settlement di L2 — Pembayaran diselesaikan di chain berbiaya rendah seperti Base, bukan Ethereum mainnet, sehingga gas hanya sepersekian sen, bukan puluhan ribu Rupiah.
  • Otorisasi off-chain — Tanda tangan Permit2 atau EIP-3009 dari pembeli gratis; tidak ada gas yang terpakai sampai transaksi settlement akhir dikirim ke chain.
  • Fasilitator membayar gas — TransX402 mengirim satu transaksi teroptimasi per pembayaran dan menanggung gas-nya sendiri, sehingga pembeli tidak pernah butuh ETH.
  • Tanpa overhead jalur kartu — Tidak ada biaya interchange, margin acquirer, atau lapisan FX lintas negara; nilai berpindah langsung dari wallet pembeli ke wallet merchant sebagai stablecoin.

Karena biaya tetap per transaksi sangat kecil di Base, mengenakan harga Rp 5.000 untuk satu artikel menjadi layak secara ekonomi — lihat Apa itu IDRX? untuk alasan TransX402 menggunakan Base sebagai default.

Mengapa x402 Penting

  • Standar terbuka — siapa saja bisa membangun client, server, atau fasilitator yang kompatibel
  • Tanpa registrasi pembeli — pembeli cukup punya wallet crypto, tidak perlu akun
  • Gasless untuk pembayar — fasilitator menanggung biaya gas
  • Kompatibel dengan AI agent — agent bisa membayar konten secara otomatis tanpa intervensi manusia
  • Ramah micropayment — lihat penjelasan di atas mengapa biaya tetap rendah untuk pembayaran kecil

Ekosistem

x402 didukung oleh ekosistem yang berkembang pesat: Coinbase adalah pengembang utama protokol yang menyediakan SDK resmi dan fasilitator CDP; Cloudflare mengintegrasikannya melalui Agents SDK dan MCP Servers; dan keduanya mendirikan x402 Foundation untuk mendorong adopsi. Protokol ini memproses 75+ juta transaksi dalam 30 hari menjelang Maret 2026.

PackageBahasaKegunaan
@x402/fetchTypeScriptClient — wrapper Fetch API
@x402/express, @x402/hono, @x402/nextTypeScriptServer middleware
x402PythonClient dan server support

Lihat dokumentasi resmi x402 untuk daftar SDK lengkap.

Peran TransX402

Fasilitator CDP dari Coinbase hanya mendukung USDC. TransX402 adalah fasilitator x402 yang dibangun khusus untuk IDRX, dan sepenuhnya kompatibel dengan ekosistem yang lebih luas — library client x402 manapun bisa diarahkan ke fasilitator TransX402. Siap mencoba? Lanjut ke Quickstart.

On this page