Stablecoin di checkout BTCPay-mu.

Instal

1. Unduh BTCPayServer.Plugins.WhollyCrypto.btcpay dan cocokkan dengan SHA256SUMSrilis. Gunakan file plugin, bukan ZIP kode sumber GitHub.
2. Sebagai admin BTCPay, buka Kelola Plugin → Unggah Plugin, unggah file, dan mulai ulang BTCPay.
3. Pilih toko → Plugin → Wholly Crypto. Instalasi saja tidak menghubungkan toko.

Pembaruan menggunakan proses unggah yang sama. Memperbarui perangkat lunak merchant Wholly tidak memperbarui plugin BTCPay.

Hubungkan toko

1. Di Wholly, buat proyek/toko aktif dengan metode yang diterima, dompet yang sudah dicadangkan, kurs, dan konfirmasi. Gunakan instalasi merchant terkini; konektor ini menargetkan API 6.4.5.
2. Salin UUID proyek/toko dari Toko → Dasar → ID API. Buat kredensial API baca/tulis yang dibatasi ke proyek. Aktifkan Toko → IPN dan salin rahasia penandatanganannya, bukan rahasia webhook.
3. Di pengaturan Wholly BTCPay, masukkan nilai tersebut beserta origin API dan checkout-mu, seperti https://api.example.com dan https://pay.example.com. Gunakan HTTPS publik pada port 443; tanpa path.
4. Aktifkan Tawarkan Wholly Crypto di checkout, simpan, lalu Uji akses baca. Jika mau, pilih sebagian dari metode yang diterima toko.

Izinkan callback HTTPS dari server Wholly-mu ke BTCPay melalui kedua firewall. Plugin menyediakan URL callback. Jangan aktifkan login browser, CAPTCHA, atau Basic Auth pada rute tersebut; pemeriksaan tanda tangan harus tetap aktif.

Checkout tersemat

Checkout halaman penuh adalah bawaan, khususnya berguna untuk aplikasi dompet seluler. Untuk iframe:

1. Di Wholly, pada Toko → Lanjutan, aktifkan Izinkan checkout tersemat. Tambahkan origin HTTPS BTCPay-mu secara persis ke Origin HTTPS yang diizinkan, tanpa path atau wildcard.
2. Di pengaturan plugin BTCPay, pilih Checkout pelanggan → Checkout tersemat (iframe) dan simpan.
3. Uji faktur baru. Faktur yang sudah ada mempertahankan mode tampilan aslinya. Buka checkout lengkap tetap tersedia untuk faktur yang sama jika frame tidak bisa dimuat.

Pesan browser dan tautan kembali adalah sarana navigasi, bukan bukti pembayaran.

Periksa alur pembayaran

Buat faktur fiat kecil bernilai positif di toko uji. Pilih Stablecoin & kripto · Wholly. Verifikasi checkout, IPN bertanda tangan, dan verifikasi API sampai konfirmasi. Penuhi pesanan hanya dari faktur BTCPay yang telah diselesaikan, satu kali per pesanan.

Uji akses baca tidak menguji pembuatan faktur atau IPN. Gunakan Koneksi dan Pembayaran tertaut untuk kesalahan yang aman, referensi pesanan, dan pemeriksaan pembayaran.