Quickstart

Panduan langkah demi langkah untuk mulai menerima pembayaran IDRX di website Anda menggunakan TransX402 — dari registrasi hingga pembayaran pertama.

Panduan ini membawa Anda dari nol hingga pembayaran IDRX pertama, lalu ke production.

Alur Onboarding Secara Garis Besar

Prasyarat

• Wallet Ethereum (MetaMask, Coinbase Wallet, atau wallet EVM lainnya)
• Website atau aplikasi yang ingin Anda monetisasi
• Node.js 18+ (jika menggunakan npm) atau cukup browser (jika menggunakan CDN)

Langkah 1: Daftar di Dashboard

Buka dashboard.transx402.com dan hubungkan wallet Anda.

1. Klik "Connect Wallet" dan pilih wallet Anda (MetaMask, Coinbase Wallet, dll.)
2. Tanda tangani pesan verifikasi (SIWE — Sign-In with Ethereum) untuk membuktikan kepemilikan wallet
3. Isi profil merchant: nama bisnis, email, dan URL website

Setelah registrasi, Anda otomatis mendapatkan API key sandbox untuk mulai testing.

Langkah 2: Dapatkan API Key

Di halaman API Keys pada dashboard, Anda akan melihat API key sandbox yang sudah dibuat:

ipk_sandbox_abc123def456...

Penting: API key lengkap hanya ditampilkan sekali saat pembuatan. Salin dan simpan dengan aman.

Prefix ipk_sandbox_ menunjukkan bahwa key ini untuk environment sandbox. Semua pembayaran akan menggunakan IDRX test di chain Anvil (gratis).

Langkah 3: Integrasikan ke Website

Opsi A: CDN (Paling Mudah)

Tambahkan script tag berikut ke halaman HTML Anda:

<script src="https://cdn.transx402.com/v1/transx402.min.js"></script>
<script>
  const client = TransX402.create({
    apiKey: 'ipk_sandbox_abc123def456...'
  });
 
  // Paywall otomatis
  TransX402.paywall({
    selector: '#konten-premium',
    price: 5000,
    currency: 'IDR',
    title: 'Artikel Premium',
    description: 'Bayar Rp 5.000 untuk membaca artikel ini'
  });
</script>

Lihat panduan Penggunaan CDN untuk detail konfigurasi lebih lanjut.

Opsi B: NPM (Untuk Aplikasi Modern)

npm install @transx402/client

import { TransX402 } from '@transx402/client';
 
const client = TransX402.create({
  apiKey: 'ipk_sandbox_abc123def456...'
});
 
// Fetch yang otomatis menangani pembayaran 402
const response = await client.fetch('https://mysite.com/api/premium-article');
const data = await response.json();

Lihat panduan Library JavaScript untuk referensi API lengkap.

Opsi C: WordPress Plugin

1. Install plugin TransX402 Paywall dari WordPress admin
2. Buka Settings > TransX402
3. Paste API key sandbox Anda
4. Pada editor post/page, aktifkan toggle "Enable Paywall"

Lihat panduan WordPress lengkap untuk detail lebih lanjut.

Langkah 4: Uji Coba di Sandbox

Fund Wallet Test

Sebelum melakukan pembayaran test, Anda perlu mengisi wallet test dengan IDRX. Gunakan endpoint sandbox:

curl -X POST https://sandbox.transx402.com/sandbox/fund \
  -H "X-API-Key: ipk_sandbox_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"address": "0xAlamatWalletAnda...", "amount": "1000000"}'

Atau gunakan halaman Sandbox di dashboard untuk mengisi wallet test melalui UI.

Lakukan Pembayaran Test

1. Buka halaman website Anda yang sudah dipasangi paywall
2. Klik "Pay with IDRX" pada overlay paywall
3. Hubungkan wallet test Anda
4. Setujui Permit2 (hanya pertama kali)
5. Tanda tangani pembayaran
6. Konten terbuka secara otomatis

Periksa di Dashboard

Setelah pembayaran berhasil, Anda bisa melihat detailnya di halaman Payments pada dashboard:

• Hash transaksi
• Alamat pembayar
• Jumlah IDRX
• Status konfirmasi
• Waktu pembayaran

Langkah 5: Go Live

Ketika integrasi sudah berjalan baik di sandbox, saatnya beralih ke production:

1. Buka halaman API Keys di dashboard
2. Klik "Create Production Key"
3. Ganti API key di kode Anda:

const client = TransX402.create({
  // Ganti sandbox key dengan production key
  apiKey: 'ipk_live_xyz789...'
});

Itu saja! Tidak ada perubahan kode lain yang diperlukan. Library secara otomatis mengarahkan ke api.transx402.com dan menggunakan Base mainnet.

Langkah Selanjutnya

• Library JavaScript — Referensi lengkap API library JS
• Penggunaan CDN — Panduan integrasi tanpa proses build
• Referensi API — Semua endpoint REST API
• Sandbox — Panduan lengkap testing di sandbox
• Webhooks — Terima notifikasi pembayaran real-time
• Mencairkan Dana — Konversi pembayaran IDRX menjadi Rupiah di rekening bank