TransX402 Docs
Integrasi

Penggunaan CDN

Instal @transx402/client via ESM CDN — tanpa proses build, untuk HTML statis dan halaman CMS tanpa backend merchant.

Ringkasan

Build CDN @transx402/client menambahkan pembayaran IDRX ke halaman HTML apa pun dengan script module — tanpa npm, tanpa bundler. Default export-nya adalah namespace TransX402 (create, paywall).

Gunakan CDN ketika:

  • Anda punya HTML statis atau CMS tanpa endpoint settle merchant
  • Anda ingin paywall sandbox tercepat
  • Anda memakai settlement langsung (browser memanggil POST /facilitate)

Gunakan package npm untuk aplikasi yang di-bundle (Next.js, Vite) di mana tipe dan tree-shaking penting. Gunakan Plugin WordPress untuk WordPress — plugin menyertakan @transx402/client dan memakai settlement server; bukan wrapper di atas script CDN ini.

Menambahkan Script

<script type="module">
  import TransX402 from "https://cdn.transx402.com/v1/transx402.browser.min.js";
  // TransX402.create / TransX402.paywall
</script>

Debug (tidak diminifikasi): https://cdn.transx402.com/v1/transx402.browser.js.

<script src="…/transx402.min.js"> klasik bukan nama file yang dipublikasikan.

Key publishable

Settlement langsung membutuhkan key publishable (ipk_pub_sandbox_ / ipk_pub_live_) dan origin halaman terdaftar di Dashboard Allowed Origins. Key rahasia ditolak jika browser mengirim Origin.

Set juga environment ("camp" sandbox, "base" production) dan merchantWallet.

Menambahkan Paywall

<!DOCTYPE html>
<html>
<head>
  <title>Blog Saya</title>
</head>
<body>
  <h1>Panduan Investasi Crypto 2026</h1>
 
  <p>Berikut adalah preview artikel...</p>
 
  <div id="konten-premium">
    <p>Ini adalah konten premium yang akan terbuka setelah pembayaran.</p>
  </div>
 
  <script type="module">
    import TransX402 from "https://cdn.transx402.com/v1/transx402.browser.min.js";
 
    TransX402.paywall({
      apiKey: "ipk_pub_sandbox_...",
      environment: "camp",
      selector: "#konten-premium",
      price: 5000,
      currency: "IDR",
      merchantWallet: "0xWalletMerchantAnda",
      title: "Konten Premium",
      description: "Bayar Rp 5.000 untuk membaca artikel lengkap",
    });
  </script>
</body>
</html>

price adalah IDR utuh (5000 = Rp 5.000). Ini melindungi #konten-premium dengan Pay with IDRX (koneksi wallet, Permit2, tanda tangan).

Opsional: TransX402.create

<script type="module">
  import TransX402 from "https://cdn.transx402.com/v1/transx402.browser.min.js";
 
  const client = TransX402.create({
    apiKey: "ipk_pub_sandbox_...",
    environment: "camp",
    settlement: "direct",
  });
 
  await client.pay({
    to: "0xWalletMerchantAnda",
    amount: "5000",
    currency: "IDR",
    resource: window.location.href,
  });
</script>

API-nya sama dengan createBrowserClient / createPaywall.

Ukuran Bundle

VarianTarget
CDN full bundle (transx402.browser.min.js)di bawah 60 KB gzipped

Bundle CDN menyertakan UI paywall dan alur wallet Path 4.

Langkah Selanjutnya

On this page