Tutorial Monetisasi API dengan Cloudflare x402
KR
Kevin Ray

Dipublikasikan 2 Juli 2026

Tutorial Monetisasi API dengan Cloudflare x402

cloud
blockchain
api
cryptocurrency

Selama 30 tahun terakhir, web berjalan pada kesepakatan ekonomi sederhana: konten ditukar dengan perhatian manusia. Perhatian itu dimonetisasi melalui iklan, subscription, atau e-commerce. Namun seiring agent menjadi pengguna internet dominan, model ini mulai rusak. Agent tidak melihat iklan atau membutuhkan subscription bulanan. Agent membaca halaman sekali, mengambil yang dibutuhkan, lalu bergerak ke tugas berikutnya.

Cloudflare merespons tren ini dengan meluncurkan Monetization Gateway, engine yang memungkinkan customer mengenakan biaya untuk asset apa pun yang dilindungi Cloudflare: web page, dataset, API, hingga MCP tools. Pada artikel ini, kita akan mempraktikkan setup dasar Monetization Gateway menggunakan protokol x402 untuk mengenkripsi endpoint API dengan micropayment stablecoin.

Prasyarat dan Konsep x402

Monetization Gateway menggunakan x402, protokol open source yang memungkinkan pembayaran melalui HTTP. Dinamai dari status code 402 Payment Required yang akhirnya dimanfaatkan. Alur x402 sangat sederhana: client meminta resource berbayar, server merespons dengan 402 beserta harga dan instruksi pembayaran, client membayar dan mengulang request dengan proof of payment, facilitator memverifikasi, lalu server mengembalikan resource.

Sebelum mulai, pastikan kamu memiliki akun Cloudflare aktif dengan domain yang sudah di-proxy. Gateway ini ditujukan untuk resource yang belum memiliki billing system sendiri. Kamu tidak perlu onboard buyer atau membangun payment gateway. Cukup tulis rule, dan agentic buyer akan membayar sesuai pemakaian.

Dokumentasi protokol x402 tersedia di x402.org, dan repositori referensi ada di GitHub coinbase/x402.

Langkah 1: Daftar ke Waitlist Monetization Gateway

Monetization Gateway masih dalam early access. Langkah pertama adalah mendaftar ke waitlist melalui form resmi Cloudflare. Setelah mendapat akses, fitur akan muncul di dashboard Cloudflare pada menu baru Monetization.

Sambil menunggu akses, persiapkan domain dan API endpoint yang ingin dikenakan biaya. Idealnya, pilih endpoint non-kritis yang sudah memiliki traffic dari AI crawler atau third-party integration. Endpoint dengan response static seperti data feed, dokumentasi teknis, atau hasil komputasi ringan adalah kandidat terbaik.

Langkah 2: Konfigurasi Payment Rule di Dashboard

Setelah Monetization Gateway aktif di akun, buat payment rule pertama. Cloudflare menyediakan API dan dashboard untuk mengelola rule ini. Rule dibangun menggunakan ekspresi mirip dengan Cloudflare firewall rules, sehingga familiar bagi tim DevOps yang sudah menggunakan platform ini.

Contoh rule untuk mengenakan biaya pada endpoint API premium:

# Charge $0.01 per GET/POST ke /api/premium/*
(http.request.uri.path matches "/api/premium/*") and
(http.request.method in {"GET" "POST"})
# Harga: $0.01 USD dalam stablecoin
# Settlement: peer-to-peer ke wallet seller

Rule juga mendukung variable pricing. Misalnya, image generation bisa dikenakan biaya variabel hingga $2 tergantung kompute yang digunakan. Atau kamu bisa mengenakan biaya hanya pada caller yang tidak terautentikasi dengan mengintersep HTTP 401 dan menggantinya dengan 402 beserta instruksi pembayaran.

Langkah 3: Setup Wallet Seller untuk Settlement

Monetization Gateway awalnya menggunakan stablecoin untuk settlement. Seller perlu wallet yang kompatibel dengan Open USD atau USDC. Proses setup wallet dilakukan di dashboard Cloudflare pada tab Wallet Configuration.

Tambahkan alamat wallet dan pilih stablecoin yang diterima. Cloudflare akan melakukan settlement peer-to-peer, artinya dana langsung masuk ke wallet seller tanpa perantara. Seller bisa menggunakan stablecoin yang terkumpul untuk transaksi sendiri atau redeem ke fiat currency melalui exchange partner.

Untuk testing di development environment, gunakan testnet stablecoin. Pastikan untuk tidak menggunakan mainnet wallet saat testing agar tidak ada risiko kehilangan dana nyata. Cloudflare menyediakan toggle environment di dashboard untuk memudahkan switching.

Langkah 4: Integrasi x402 di Origin Server

Meskipun Cloudflare menangani payment verification di edge, origin server tetap perlu mengetahui bahwa request telah lolos pembayaran. Cara paling sederhana adalah dengan memeriksa header tambahan yang disisipkan oleh Monetization Gateway setelah verifikasi berhasil.

Contoh middleware Express.js untuk menangani request yang masuk:

const express = require('express');
const app = express();

app.get('/api/premium/data', (req, res) => {
    // Verifikasi header dari Cloudflare Gateway
    const paymentProof = req.headers['x-payment-verified'];
    if (paymentProof !== 'true') {
        return res.status(402).json({
            error: 'Payment Required',
            x402_url: 'https://gateway.cloudflare.com/pay',
            price: '0.01',
            asset: 'USDC'
        });
    }
    res.json({ data: 'Premium dataset content' });
});

app.listen(3000);

Pada production, header verifikasi ini tidak perlu dicek manual karena Cloudflare sudah memblokir request tanpa pembayaran di edge. Namun, menambahkan pengecekan di origin memberikan defense in depth jika ada request yang bypass proxy.

Langkah 5: Uji Alur Pembayaran dengan Test Agent

Setelah rule dan wallet dikonfigurasi, uji end-to-end menggunakan test agent. Cloudflare menyediakan sandbox environment yang mensimulasikan agent buyer. Alur yang diharapkan:

  1. Agent mengirim request ke endpoint premium.

  2. Cloudflare merespons 402 dengan payload harga dan asset.

  3. Agent melakukan pembayaran stablecoin ke alamat yang ditentukan.

  4. Agent mengulang request dengan proof of payment di header.

  5. Cloudflare memverifikasi pembayaran dan meneruskan request ke origin.

  6. Origin mengembalikan resource yang diminta.

Latency target untuk seluruh handshake adalah sub-second karena verifikasi dilakukan di edge Cloudflare yang tersebar di 330+ kota. Gunakan logging di dashboard untuk memantau jumlah request berbayar, total revenue, dan conversion rate.

Langkah 6: Deploy ke Production dan Pantau Metrik

Setelah testing berhasil, aktifkan rule untuk production traffic. Cloudflare Monetization Gateway mendukung manajemen rule as code melalui API dan Terraform, sehingga endpoint berbayang bisa diatur bersama konfigurasi infrastructure lainnya.

resource "cloudflare_ruleset" "monetization" {
  zone_id = var.zone_id
  name    = "monetization-gateway"
  kind    = "zone"
  phase   = "http_request_main"

  rules {
    action = "monetize"
    expression = "(http.request.uri.path matches \"/api/premium/*\")"
    action_parameters {
      price = "0.01"
      asset = "USDC"
    }
  }
}

Pantau metrik revenue dan request volume melalui dashboard Analytics. Jika traffic dari AI crawler meningkat drastis, Monetization Gateway akan otomatis mengkonversinya menjadi revenue tanpa membebani origin dengan request tak terbayar. Ini adalah model bisnis baru untuk web yang agent-first.

Kesimpulan

Cloudflare Monetization Gateway dan protokol x402 membuka peluang monetisasi untuk resource digital yang selama ini tidak terbayar. Dengan setup yang relatif sederhana, developer bisa mulai mengenakan biaya per-request pada API, dataset, dan tools mereka. Model ini cocok untuk era di mana agent menjadi pembeli utama di internet.

Langkah selanjutnya: eksplorasi integrasi dengan Web Bot Auth untuk mengenakan biaya terhadap agent terverifikasi, atau gabungkan dengan Cloudflare AI Gateway untuk monetisasi inference endpoint. Baca pengumuman resmi di blog.cloudflare.com/monetization-gateway dan pelajari spesifikasi x402 di github.com/coinbase/x402.

Gambar: Cloudflare Blog