Contoh penggunaan

Menerima pembayaran kripto di toko online, tanpa plugin

Toko online menerima kripto dengan Crypto Merchant dengan membuat satu invoice per pesanan melalui REST API dan mengarahkan pelanggan ke halaman checkout invoice tersebut yang di-hosting. Pelanggan memilih koin, membayar jumlah tepat dengan kurs yang dikunci untuk invoice itu, dan server Anda mengirim pesanan saat webhook invoice.paid bertanda tangan tiba. Biayanya 1% per invoice lunas. Tidak ada plugin WooCommerce, Shopify, atau Magento: integrasinya adalah satu panggilan API dan satu endpoint webhook.

Diperbarui 6 November 2026

Semua yang ada di halaman ini menjelaskan cara kerja Crypto Merchant saat ini, sebagaimana tertulis di referensi API, dokumentasi checkout, dan Harga. Tidak ada klaim apa pun di sini tentang gateway lain.

Sekilas

Topik	Cara kerjanya
Cara pelanggan membayar	Di halaman invoice yang di-hosting: mereka memilih koin dan jaringan dari yang Anda terima, melihat jumlah tepat dan alamat deposit yang dibuat untuk invoice tersebut, dengan kode QR dan hitung mundur.
Apa yang Anda bangun	Satu panggilan `POST /invoices` saat pelanggan memilih kripto, dan satu endpoint HTTPS untuk webhook. Bahasa atau framework apa pun yang dapat membuat permintaan HTTPS.
Kapan mengirim	Pada event `invoice.paid`, setelah pembayaran mendapat konfirmasinya. Jangan pernah pada `invoice.confirming`.
Jumlah yang salah	Pembayaran yang kurang tidak lebih dari toleransi Anda dianggap lunas. Kekurangan yang lebih besar membuat invoice menjadi `underpaid`: pelanggan dapat menambah pembayaran atau mengambil kembali apa yang mereka kirim. Pembayaran berlebih tetap dianggap lunas, dan kelebihannya ditahan untuk pelanggan.
Mata uang harga	Dolar AS secara default, atau mata uang lain yang didukung seperti EUR, GBP, TRY, atau BRL; jumlah dalam koin dihitung dari harga live saat pelanggan memilih koin.
Plugin	Tidak ada. Alur di bawah ini bekerja dengan keranjang belanja atau checkout kustom apa pun yang dapat memanggil API.

Bagaimana cara kerjanya, langkah demi langkah?

Dari saat pelanggan memilih “Bayar dengan kripto” hingga pesanan keluar dari gudang Anda:

1
Buat invoice saat checkout
Saat pelanggan memilih kripto, server Anda memanggil POST /invoices dengan total pesanan, order_id Anda, email pelanggan, redirect_url kembali ke halaman terima kasih Anda, dan metadata apa pun yang ingin Anda terima kembali. Balasannya adalah invoice dengan checkout_url.
2
Arahkan pelanggan ke halaman invoice
Alihkan ke checkout_url. Halaman ini mencantumkan koin yang Anda terima; saat pelanggan memilih salah satunya, jumlah dalam koin tersebut dihitung dari harga live dan dikunci, dan alamat deposit yang dibuat untuk invoice ini ditampilkan dengan kode QR. Invoice tetap terbuka selama waktu yang Anda tetapkan, 30 menit secara default.
3
Terima webhook bertanda tangan
Endpoint Anda menerima invoice.confirming saat pembayaran terlihat on-chain dan invoice.paid setelah konfirmasinya cukup. Verifikasi header CM-Signature, simpan event-nya, balas dengan 2xx dalam 10 detik, lalu lepaskan pesanan dari salinan yang Anda simpan. Event dapat tiba dua kali: gunakan id event agar pengiriman hanya sekali.
4
Tangani tiga kasus khusus
invoice.expired: tidak ada pembayaran yang tiba tepat waktu, jadi tawarkan invoice baru. invoice.underpaid: pelanggan dapat mengirim sisanya ke alamat yang sama atau mendapatkan pengembalian dari halaman invoice. Invoice yang lebih bayar tetap lunas; kelebihannya ditahan untuk pelanggan, yang dapat menariknya dari halaman invoice.
5
Cairkan dana
Pembayaran yang terkonfirmasi dikreditkan ke saldo Anda dikurangi 1% dan di-sweep ke dompet pool bisnis Anda. Cairkan kapan saja ke alamat Anda sendiri, setiap koin apa adanya atau semuanya dikonversi ke satu koin simpanan.

Satu panggilan API yang dibutuhkan

Buat invoice saat checkout

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

Berapa biayanya?

1% dari setiap invoice lunas, dipotong saat pembayaran dikreditkan ke saldo Anda. Tidak ada biaya pendaftaran, tidak ada biaya bulanan, dan tidak ada pembayaran untuk mulai aktif; invoice yang kedaluwarsa dan dibatalkan tidak dikenai biaya. Memindahkan koin (sweep, konversi, dan pencairan) dikenai biaya gas, yang diambil dari saldo gas Anda jika Anda menambahkannya, atau jika tidak, dari koin yang dipindahkan. Pelanggan juga membayar biaya gas pada setiap invoice: biaya ini ditambahkan ke jumlah yang mereka kirim, ditampilkan di checkout, dan tidak pernah lebih dari US$5. Kurs konversi sudah termasuk margin layanan sebesar 1%. Semua biaya ada dalam satu tabel di Harga.

Apa yang tidak dilakukan Crypto Merchant di sini

Tanpa plugin toko. Tidak ada modul WooCommerce, Shopify, Magento, PrestaShop, maupun OpenCart. Anda menambahkan panggilan API sendiri, atau membagikan halaman checkout dan link pembayaran Anda.
Tanpa pengembalian dana otomatis, dan tanpa panggilan pengembalian dana di API. Pembayaran kripto yang terkonfirmasi bersifat final, jadi pengembalian dana adalah transfer baru. Untuk retur, Admin membuat link pengembalian dana pribadi dari pembayaran yang sudah lunas di portal; pelanggan memasukkan alamatnya sendiri, biaya jaringan diambil dari pengembalian dana, dan biaya 1% tidak dikembalikan.
Kustodian, hanya kripto. Crypto Merchant memegang kunci sampai Anda mencairkan, dan pencairan dikirim ke alamat dompet Anda sendiri, bukan ke rekening bank.

Untuk siapa ini?

Toko yang sudah menjalankan checkout sendiri dan dapat menambahkan satu panggilan API dan satu webhook.
Toko yang menjual kepada pelanggan di negara-negara yang sulit mendapatkan kartu atau yang dirugikan oleh chargeback.
Toko yang menetapkan harga dalam dolar dan ingin menyelesaikan pembayaran dalam USDT atau USDC.

Pertanyaan yang sering diajukan

Apakah ada plugin WooCommerce atau Shopify untuk Crypto Merchant?

Tidak. Integrasinya adalah satu panggilan API yang membuat invoice dan satu endpoint webhook yang mendengar saat invoice dibayar. Jika plugin sangat penting, halaman alternatif mencantumkan gateway yang memilikinya.

Berapa lama pembayaran kripto terkonfirmasi?

Bergantung pada jaringannya. Setiap jaringan memiliki jumlah konfirmasi yang ditetapkan, tercantum di Koin & jaringan. Stablecoin di Tron, Solana, BNB Smart Chain, Polygon, Base, dan Arbitrum biasanya terkonfirmasi dalam beberapa menit; Bitcoin memerlukan 2 konfirmasi, biasanya sekitar 20 menit.

Apa yang terjadi jika pelanggan membayar dengan jumlah yang salah?

Kekurangan dalam batas toleransi Anda dianggap lunas. Kekurangan yang lebih besar membuat invoice menjadi kurang bayar, dan pelanggan dapat menambah pembayaran atau mengambil kembali apa yang mereka kirim dari halaman invoice. Pembayaran berlebih tetap dianggap lunas, dan kelebihannya ditahan agar dapat ditarik pelanggan.

Apakah pelanggan memerlukan akun Crypto Merchant?

Tidak. Pelanggan hanya memerlukan dompet dengan koin yang ingin mereka pakai untuk membayar. Mereka membuka halaman invoice, memilih koin, dan mengirim jumlah yang ditampilkan.

Bisakah saya menetapkan harga pesanan dalam euro atau mata uang lain?

Ya. Invoice dihargai dalam dolar AS secara default, dan kolom mata uang menerima mata uang lain yang didukung seperti EUR, GBP, TRY, atau BRL. Jumlah dalam koin dihitung dari harga live saat pelanggan memilih koin.

Contoh penggunaan lain

Semua contoh penggunaan

Mulai terima kripto hari ini

Pendaftaran gratis tanpa perlu dokumen, 1% per invoice lunas, dan pencairan kapan pun Anda mau.

Buat akun Anda Baca dokumentasi