Dokumentasi

blockwallets memungkinkan Anda menerima USDT dan USDC, plus BTC, LTC, dan koin native (dikreditkan dalam dolar AS dengan kurs yang dikunci). Setiap integrasi di bawah membuat jenis tagihan yang sama di halaman pembayaran yang sama, dengan konfirmasi, biaya, dan saldo yang sama; bedanya hanya pada cara sistem Anda berbicara dengan kami. Pilih yang paling cocok, lalu ikuti halamannya.

Pilih integrasi

Dikelompokkan menurut titik awal Anda. Setiap kartu membuka panduan lengkapnya.

Tanpa kode

Terima pembayaran dari dasbor merchant; tidak ada yang perlu dipasang.

Integrasi API baru

Anda menulis integrasinya dari awal.

Pindah dari gateway lain

Pertahankan kode Anda: API kompatibel, jadi Anda hanya mengganti base URL dan kunci.

Biar AI yang mengintegrasikan

Untuk yang tidak menulis kode tetapi memakai alat coding AI.

Alat

Bantuan debugging yang berjalan di browser Anda.

Kompatibel Cryptomus atau native?

Keduanya membuat tagihan yang sama di halaman pembayaran yang sama, dengan biaya dan saldo yang sama. Bedanya ada pada gaya permintaan, format webhook, dan cara Anda mendapatkan kredensial.

Mulai dari awal? Pakai REST API native: jumlah dalam sen, ref idempoten, tanda tangan webhook bercap waktu, dan kunci yang Anda buat sendiri di dasbor. Sudah memakai Cryptomus, atau ingin memakai SDK atau plugin Cryptomus yang ada? Pakai API kompatibel Cryptomus.

Mulai cepat

Dari nol sampai pembayaran uji dalam lima langkah (API kompatibel Cryptomus; API lain mengikuti langkah yang sama dengan kredensialnya sendiri).

1. Minta akses di beranda. Setelah disetujui, masuk ke dasbor merchant.
2. Buka “Developer › Integrasi & kunci” di dasbor, buat merchant dan API key di kolom Test, lalu tambahkan domain situs Anda.
3. Server Anda membuat tagihan dengan POST /v1/payment dan mengarahkan pelanggan ke result.url.
4. Bayar dengan “Simulasikan pembayaran” di halaman pembayaran, lalu pastikan handler webhook Anda memverifikasi sign dan mengkreditkan sesuai payment_amount_usd.
5. Beralih ke kredensial di kolom Live dan bayar sejumlah kecil uang sungguhan satu kali (“Coba satu pembayaran” di beranda dasbor).

POST https://blockwallets.io/v1/payment
merchant: <merchant>
sign: md5(base64(body) + API key)
Content-Type: application/json

{
  "amount": "42.00",
  "currency": "USD",
  "order_id": "order_1042",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_return": "https://shop.example/cart",
  "url_success": "https://shop.example/thanks?order=1042"
}

Kode Node.js, PHP, dan Python untuk setiap langkah ada di dokumentasi API kompatibel Cryptomus; jika Anda lebih suka AI yang mengerjakannya, mulai dengan pembuat prompt.

Tautan pembayaran (tanpa kode)

Dasbor merchant → “Pembayaran › Tautan pembayaran” → isi keterangan dan jumlah (tentukan jaringan atau biarkan pelanggan memilih) → buat. Setiap tautan punya URL dan kode QR.

• Setiap kali seseorang membuka tautan, tagihan baru dibuat, jadi satu tautan bisa dipakai berulang (misalnya “Keanggotaan $99”).
• Setiap pembayaran muncul di “Pembayaran › Pembayaran masuk”; tarik ke dompet Anda dari “Dana › Saldo & penarikan”.
• Jika Anda sudah membuat kredensial dan URL webhook di “Developer › Integrasi & kunci”, pembayaran lewat tautan juga diberitahukan, dalam format webhook kompatibel Cryptomus.
• Untuk berhenti menerima, klik “Nonaktifkan” dan tautan langsung tidak berfungsi.

POS untuk toko

Untuk meja kasir dan lapak: dasbor merchant → “Pembayaran › Kasir POS” → buka terminal dan dapatkan tautan POS. Staf membukanya di ponsel atau tablet, mengetik jumlah, lalu kode QR pembayaran muncul; saat pelanggan membayar, layar menampilkan “Paid”.

• Tagihan POS berlaku 30 menit. Dana masuk ke saldo Anda dan muncul di “Pembayaran › Pembayaran masuk”, dan Anda diberi tahu di URL webhook seperti tautan pembayaran.
• Tautan POS hanya bisa menerima pembayaran: tidak bisa melihat saldo, penarikan, pesanan lain, pengaturan, atau kredensial Anda.
• Perangkat hilang, atau staf sudah keluar? Cabut terminal itu di dasbor dan tautannya langsung berhenti berfungsi.

Tombol sematan

Dasbor merchant → “Pembayaran › Tautan pembayaran” → “Tombol sematan”: pilih teks, warna, ukuran, dan bentuk lalu salin snippet-nya. Mengklik tombol membuka halaman pembayaran dari tautan pembayaran itu.

• HTML biasa: satu tautan bergaya tanpa script, sehingga berfungsi di mana pun HTML bisa ditempel (pembuat situs, forum, tanda tangan email).
• Dengan script: tambahkan data-blockwallets dan satu tag /embed.js; di desktop halaman pembayaran terbuka di jendela kecil di tengah, di ponsel terbuka seperti biasa.
• Script tidak mengirim permintaan, tidak menyetel cookie, dan tidak menambah iframe. Jika halaman memblokirnya, tombol tetap berupa tautan biasa yang berfungsi.

Pada cuplikan di bawah, ganti /l/pl_… dengan alamat tautan pembayaran Anda sendiri.

HTML biasa

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + script

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>