Pemroses pembayaran melakukan lebih dari sekadar mengambil biaya. Ia menahan dana Anda, melihat pelanggan Anda, dan dapat membekukan akun Anda. BTCPay Server adalah perangkat lunak open-source gratis yang memungkinkan Anda menerima Bitcoin langsung ke dompet yang Anda kendalikan. Ia berjalan di VPS, dan panduan ini menunjukkan instalasi standar berbasis Docker.
Yang Anda perlukan
- VPS dengan 2 vCPU, RAM 4 GB, dan disk 80 GB jika Anda menjalankan node Bitcoin pruned bersamanya. Lebih kecil jika Anda mengarahkannya ke node eksternal.
- Nama domain, misalnya
pay.example.com, dengan catatan A yang mengarah ke server. - Ubuntu 22.04 atau 24.04 dengan Docker terinstal dan penyiapan SSH yang sudah diperkuat.
Langkah 1: arahkan domain
Buat catatan A terlebih dahulu dan tunggu hingga ter-resolve. Penginstal meminta sertifikat Let's Encrypt untuk nama tersebut, dan akan gagal jika catatannya tidak ada. Panduan DNS kami membahasnya.
Langkah 2: jalankan penginstal resmi
sudo su -
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
export BTCPAY_HOST="pay.example.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="clightning"
export BTCPAYGEN_REVERSEPROXY="nginx"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-s"
export LETSENCRYPT_EMAIL="you@example.com"
. ./btcpay-setup.sh -i
Fragmen opt-save-storage-s melakukan pruning blockchain untuk menghemat disk. Sinkronisasi awal bisa memakan waktu berjam-jam, dan toko dapat dipakai untuk invoice setelah node tersusul. Lightning bersifat opsional, jadi hapus baris itu jika Anda tidak menginginkannya.
Langkah 3: buat admin dan toko
Buka domain Anda, daftarkan akun pertama (akun ini menjadi admin server), lalu nonaktifkan pendaftaran publik di Server Settings. Buat toko dan atur mata uang defaultnya.
Langkah 4: hubungkan dompet yang Anda kendalikan
Buat dompet di hardware wallet atau perangkat Anda sendiri, dan tempel hanya kunci publiknya (xpub) ke BTCPay. Jangan membuat hot wallet di server jika bisa dihindari, karena dana lalu bergantung pada keamanan server. Pembayaran langsung masuk ke alamat yang diturunkan dari kunci publik Anda.
Langkah 5: uji dan integrasikan
Buat invoice uji dan bayar dalam jumlah kecil. Lalu instal plugin untuk toko Anda (WooCommerce, Shopify, kunci API kustom) mengikuti dokumentasi BTCPay.
Jaga agar tetap aman
- Aktifkan autentikasi dua faktor pada admin.
- Cadangkan data BTCPay dengan skrip cadangan bawaan dan simpan di luar server dalam keadaan terenkripsi.
- Perbarui dengan
btcpay-update.sh, setelah membaca catatan rilis. - Jalankan firewall dengan hanya SSH, 80, dan 443 yang terbuka.
Untuk mengetahui koin mana yang cocok bagi pelanggan Anda, baca kripto termurah untuk pembayaran. Menjalankan node pendukung sendiri? Lihat menjalankan node Bitcoin.