BTCPay Server per commercianti : dispiegamento completo

Accettare Bitcoin lato commerciante ha richiesto a lungo o di passare da un acquirer centralizzato che prende una commissione dell'1 % e tiene i fondi in custody×CustodyLa custodia dei fondi. Vedi self-custody e custodial nella sezione dedicata più in basso.Vedi nel lessico → (BitPay, Coinbase Commerce dei primi tempi), o del bricolage manuale tramite un wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico → Bitcoin generico. BTCPay Server, lanciato da Nicolas Dorier nel 2017, ha cambiato questa equazione : un server open source×Open sourceSoftware il cui codice sorgente è pubblico e modificabile da chiunque. Garanzia di auditabilità fondamentale in Bitcoin.Vedi nel lessico →, gratuito, self-hosted, che genera fatture, integra l'e-commerce, e tiene i fondi in un wallet controllato dal commerciante.

Nel 2026, BTCPay Server è portato dalla BTCPay Server Foundation e dispiegato su migliaia di istanze. Più di 500 commercianti europei identificati (ristoranti, freelance, e-commerce) lo usano in produzione. L'ecosistema conta integrazioni native WooCommerce, Magento, Shopify, PrestaShop, terminali fisici BTCPay POS, e uno store di estensioni comunitarie (paga in Bitcoin via Bitwage, integrazione contabile, ecc.).

Questo articolo copre le due vie di dispiegamento, l'integrazione alle piattaforme e-commerce comuni, il terminale fisico BTCPay POS, la decisione conversione automatica EUR vs ritenzione BTC, e il confronto con le alternative terze non self-hosted (OpenNode, Strike, IBEX Pay).

Due vie di dispiegamento : VPS dedicato o integrazione Umbrel

Via 1 : VPS×VPS (Virtual Private Server)Server virtuale affittato presso un hoster (Hetzner, DigitalOcean, OVH), accessibile via SSH. Costo tipico fra 5 e 30 EUR al mese.Vedi nel lessico → dedicato BTCPay. Il metodo storico. Affittare un VPS (DigitalOcean, Hetzner, OVH o altro, a partire da 10-15 EUR/mese secondo spec), scegliere Ubuntu 22.04 o 24.04 LTS, lanciare lo script BTCPay One-Click (btcpayserver-docker×DockerTecnologia che impacchetta un'applicazione e le sue dipendenze in un container isolato, avviabile con un comando su qualsiasi sistema.Vedi nel lessico →/btcpay-setup.sh). Lo script dispiega un docker-compose con Bitcoin Core×Bitcoin CoreImplementazione di riferimento del software Bitcoin, scritta in C++ e mantenuta da una comunità open source. È il software utilizzato dalla maggior parte dei nodi.Vedi nel lessico → in modalità pruned, BTCPay, LND per Lightning, NBXplorer per l'indicizzazione, e Nginx per il reverse proxy. In 30-45 minuti, l'istanza è online, accessibile tramite un URL HTTPS a vostra scelta.

Via 2 : integrazione Umbrel×UmbrelDistribuzione equivalente per mini-PC o Raspberry Pi, con interfaccia web curata e app store (BTCPay, mempool.space, Sparrow Server, ecc.).Vedi nel lessico →/Start9×Start9 (StartOS)Alternativa a Umbrel con focus su sovranità e privacy. Più impegnativa tecnicamente, più rigorosa sulla privacy.Vedi nel lessico →/RaspiBlitz×RaspiBlitzDistribuzione software chiavi in mano per trasformare un Raspberry Pi in un nodo Bitcoin e Lightning. Pioniere del genere, con community in lingua tedesca molto attiva.Vedi nel lessico →. Se avete già un mini-PC×Mini-PC (NUC)Piccolo computer fanless come Intel NUC, Beelink o Minisforum. Più potente di un Raspberry Pi, ideale per un nodo serio con Lightning e BTCPay.Vedi nel lessico → o Raspberry Pi×Raspberry PiPiccolo computer delle dimensioni di una carta di credito, a basso costo (60 a 100 EUR). Permette di gestire un nodo Bitcoin a casa.Vedi nel lessico → sotto Umbrel o Start9 per far girare il vostro nodo×Nodo (node)Computer che esegue il software Bitcoin e partecipa alla rete validando blocchi e transazioni. Un « full node » conserva una copia completa della blockchain.Vedi nel lessico →, BTCPay è disponibile come app installabile dal loro store. Due click, qualche minuto di attesa per scaricare le immagini Docker, e l'app gira sul vostro Bitcoin Core locale. Più semplice della via VPS, ma limitato a un uso modesto : un Raspberry Pi 5 supporta un commercio medio ma non un grosso e-commerce con centinaia di ordini all'ora.

Primo accesso. Navigare all'URL BTCPay, creare un account admin (primo account = admin), seguire l'assistente : creare uno store (il profilo del vostro commercio), collegare un wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico → (xpub×xpub (extended public key)Chiave pubblica estesa. Consente a un wallet in sola lettura di conoscere indirizzi e saldi senza poter firmare. Utilizzata per tracking e osservazione.Vedi nel lessico → da Sparrow/Specter o seed phrase×Seed phrase (frase di recupero)Sequenza di 12 o 24 parole (di solito in inglese) che codifica la tua chiave maestra. Backup universale di un wallet : con queste parole puoi ripristinare i tuoi fondi su qualsiasi software compatibile.Vedi nel lessico → per wallet hot), configurare la conversione fiat×Fiat (moneta fiat)Moneta statale a corso legale (euro, franco svizzero, dollaro), emessa da una banca centrale e senza ancoraggio a un bene fisico. Al contrario, Bitcoin ha un'emissione limitata a 21 milioni di unità, senza emittente centrale.Vedi nel lessico → opzionale. In 15 minuti, potete generare la vostra prima fattura e regolarla da un wallet test.

Integrazioni e-commerce : WooCommerce, Magento, Shopify

WooCommerce (WordPress) è l'integrazione più matura. Il plugin BTCPay for WooCommerce, distribuito sul repository WordPress, aggiunge Bitcoin e Lightning come metodi di pagamento tra i classici (carta bancaria Stripe, bonifico). Configurazione : installare il plugin, incollare l'URL e la chiave API×API (Application Programming Interface)Interfaccia che permette a un programma di interrogare un altro programma o servizio. mempool.space espone un'API pubblica per interrogare la chain.Vedi nel lessico → del vostro BTCPay Server, collegare gli store, attivare Bitcoin e Lightning in WooCommerce. Quindici minuti in tutto.

Magento, PrestaShop, OpenCart. Plugin ufficiali disponibili sul repo×Repo (repository)Repository di codice su GitHub o piattaforma equivalente. Il repo di Bitcoin Core è github.com/bitcoin/bitcoin.Vedi nel lessico → BTCPay GitHub×GitHubPiattaforma web dove sono ospitati gran parte dei progetti open source del mondo, fra cui Bitcoin Core, electrs, BDK, LDK. Permette di vedere il codice, lo storico delle modifiche e di proporre contributi.Vedi nel lessico →, configurazione simile. Per Magento 2, il plugin BTCPay-for-magento2 è mantenuto dalla comunità. Shopify è un caso particolare : Shopify non permette un plugin di pagamento crypto direttamente (politica Shopify), bisogna passare da un'integrazione terza (Coincharge o simile) che rinvia a BTCPay. Più frizione ma possibile.

Piattaforme custom (negozio PHP×PHPLinguaggio di programmazione lato server utilizzato da CapBitcoin. Gira sulla maggior parte degli hosting condivisi.Vedi nel lessico →, Node.js, Django, ecc.). BTCPay espone un'API REST completa documentata su docs.btcpayserver.org. Creare una fattura via POST /api/v1/stores/{storeId}/invoices, ricevere un webhook quando il pagamento è confermato, aggiornare l'ordine nel proprio backoffice. Lo sviluppo richiede una giornata per uno sviluppatore backend Bitcoin-familiare, più qualche giorno per integrare in modo pulito con gestione errori e rimborsi.

Terminale fisico BTCPay POS per negozio

Per i commerci fisici (ristorante, caffè, negozio, laboratorio), BTCPay POS è un'interfaccia tattile dedicata che trasforma un tablet o telefono in un terminale di cassa Bitcoin. Disponibile nativamente in BTCPay Server : Apps → POS App. Configurare una lista di articoli con prezzo EUR (o CHF, ecc.), scegliere la visualizzazione (categorie o lista piatta), attivare.

Uso : il dipendente apre BTCPay POS sul tablet (URL bookmarcato), seleziona gli articoli venduti, il totale si visualizza, clicca « Pay with Bitcoin ». Un QR code×QR code (codice QR)Codice a barre bidimensionale, onnipresente in Bitcoin: indirizzi, invoice Lightning, URI di pagamento. Verificare sempre importo e indirizzo decodificati prima di confermare.Vedi nel lessico → appare sullo schermo, il cliente lo scansiona con il suo wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico → Lightning (Phoenix, Muun, Wallet of Satoshi×Satoshi (sat)La più piccola unità di bitcoin. 1 BTC = 100 milioni di satoshi. Nome ispirato al creatore. Nel 2026, ragionare in sat diventa abituale man mano che il prezzo di un BTC sale.Vedi nel lessico →). Conferma visiva e sonora in BTCPay POS appena il pagamento Lightning è confermato (tipico : 2 secondi). Il denaro è nel vostro wallet BTCPay, esso stesso controllato dalla vostra seed phrase×Seed phrase (frase di recupero)Sequenza di 12 o 24 parole (di solito in inglese) che codifica la tua chiave maestra. Backup universale di un wallet : con queste parole puoi ripristinare i tuoi fondi su qualsiasi software compatibile.Vedi nel lessico → o multisig×Multisig (multi-firma)Configurazione in cui una transazione deve essere firmata da più chiavi indipendenti per essere valida (ad esempio 2 chiavi su 3). Riduce il rischio che un singolo furto di chiave faccia perdere i fondi.Vedi nel lessico →.

Hardware. Qualsiasi tablet Android o iPad da 8-10 pollici con un browser recente basta. Investimento iniziale : 200-400 EUR per un tablet decente e il suo supporto da cassa. Connessione : WiFi locale stabile. Piano B in caso di guasto BTCPay : un wallet Lightning mobile classico su smartphone (Phoenix con indirizzo Lightning statico). Nel 2026, è diventato un setup standard per i commerci che accettano seriamente Bitcoin.

Conversione automatica EUR vs ritenzione BTC

Decisione strategica per un commerciante : quando un pagamento Bitcoin arriva, bisogna tenerlo in BTC o convertirlo automaticamente in EUR per stabilizzare la tesoreria ? Le due opzioni sono valide secondo il profilo, la fiscalità e l'appetito al rischio.

Ritenzione BTC. Il pagamento arriva in sats nel vostro wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico → BTCPay e vi resta. Vantaggi : esposizione al rialzo Bitcoin (interessante se avete una tesi rialzista), nessun costo di conversione, controllo totale. Svantaggi : volatilità (può perdere il 30 % in qualche settimana), gestione fiscale più complessa (ogni vendita futura scatena una plusvalenza×Plusvalenza, minusvalenzaGuadagno (o perdita) realizzato alla cessione di un attivo: differenza tra prezzo di vendita e prezzo di acquisto. In Italia le plusvalenze crypto sono tassate al 26 percento; le minusvalenze si compensano.Vedi nel lessico → da calcolare), tesoreria in moneta volatile per costi in EUR. Più adatto a una piccola proporzione (10-30 %) del fatturato, conservata volontariamente come treasury Bitcoin.

Conversione automatica. BTCPay Server può essere configurato con un connettore exchange×Exchange (piattaforma di scambio)Servizio che permette di acquistare, vendere e scambiare cripto contro monete fiat. Esempi : Kraken, Coinbase, Bitstamp, Bitvavo. La maggior parte è custodial.Vedi nel lessico → (Kraken, Bitfinex via API×API (Application Programming Interface)Interfaccia che permette a un programma di interrogare un altro programma o servizio. mempool.space espone un'API pubblica per interrogare la chain.Vedi nel lessico →) che converte ogni pagamento ricevuto in EUR istantaneamente. Vantaggi : tesoreria stabile in EUR, contabilità più semplice, eliminazione del rischio volatilità. Svantaggi : commissione exchange (tipicamente 0,1-0,3 %), esposizione al fallimento dell'exchange (non lasciarvi più del necessario). Più adatto per la maggioranza del flusso commerciale. Configurazione raccomandata 2026 : 80-90 % conversione auto, 10-20 % ritenzione BTC.

Alternative terze : OpenNode, Strike, IBEX Pay

Se auto-ospitare BTCPay è troppo tecnico o troppo costoso per un avvio, diversi servizi terzi propongono un'esperienza simile in custodial×CustodialModello in cui un terzo (exchange, broker, neobanca) detiene le tue chiavi private al posto tuo. Hai un credito, non un bitcoin. « Not your keys, not your coins ».Vedi nel lessico → : gestiscono l'infrastruttura, voi pagate una commissione di servizio. Tre attori dominano nel 2026.

OpenNode (USA, dal 2018). Servizio custodial completo, integrazioni e-commerce identiche a BTCPay (WooCommerce, Magento, Shopify), conversione automatica in USD/EUR proposta. Commissione tipica : 1 % per transazione riuscita, gratuità fino a una certa soglia. Vantaggio : zero infrastruttura da gestire. Svantaggio : fiducia in OpenNode (tengono i vostri fondi tra pagamento e prelievo, hanno una licenza MSB americana quindi reporting fiscale IRS×IRSAmministrazione fiscale degli Stati Uniti. Per gli espatriati americani, la rendicontazione cripto all'IRS resta obbligatoria anche fuori dagli USA.Vedi nel lessico → possibile).

Strike (USA, Jack Mallers, dal 2019). Più orientato grand public e Lightning Address×Lightning AddressIndirizzo simile a un'email (alice@strike.me) che permette di ricevere pagamenti Lightning senza generare ogni volta una fattura.Vedi nel lessico → (pagamento tramite indirizzo email-like tipo alice@strike.me). Commissione bassa (0,3 % o meno secondo volume). Eccellente per i freelance che fatturano all'internazionale, e per i commercianti americani. Meno diffuso in Europa per copertura geografica parziale. IBEX Pay (El Salvador×El SalvadorPrimo paese ad aver adottato Bitcoin come moneta legale, a settembre 2021 sotto Nayib Bukele. Lo status è stato modificato nel 2025 sotto pressione dell'FMI.Vedi nel lessico →, dal 2021). Focus America latina e Europa. Custodial con offerta Lightning nativa, commissioni competitive. Cruscotto commerciante più orientato business che tecnico. Decisione nel 2026 : BTCPay per chi può auto-ospitare (sovranità massima), OpenNode/Strike/IBEX per chi parte e vuole semplice.

Manutenzione, sicurezza, backup

Manutenzione. Un'istanza BTCPay self-hosted richiede un po' di cura. Aggiornamento : uno script btcpay-update.sh ruota le immagini Docker×DockerTecnologia che impacchetta un'applicazione e le sue dipendenze in un container isolato, avviabile con un comando su qualsiasi sistema.Vedi nel lessico → verso le ultime versioni, da eseguire ogni 1-2 mesi. Sorveglianza : BTCPay logga gli errori, da consultare occasionalmente tramite SSH×SSH (Secure Shell)Protocollo per connettersi da remoto alla linea di comando di un server in modo cifrato.Vedi nel lessico →. Spazio disco : un nodo×Nodo (node)Computer che esegue il software Bitcoin e partecipa alla rete validando blocchi e transazioni. Un « full node » conserva una copia completa della blockchain.Vedi nel lessico → Bitcoin pruned consuma ~50 GB, da sorvegliare. Backup : esportare regolarmente le configurazioni (Settings → Maintenance → Export), conservare fuori dal VPS×VPS (Virtual Private Server)Server virtuale affittato presso un hoster (Hetzner, DigitalOcean, OVH), accessibile via SSH. Costo tipico fra 5 e 30 EUR al mese.Vedi nel lessico → per poter ricostruire in caso di perdita.

Sicurezza. Le buone pratiche : 2FA×2FA (Two-Factor Authentication)Autenticazione a due fattori. Oltre alla password viene richiesto un secondo elemento per accedere (codice TOTP, SMS, chiave fisica). Standard su ogni piattaforma seria.Vedi nel lessico → attivato sull'account admin (TOTP×TOTP (Time-based One-Time Password)Codice a 6 cifre che cambia ogni 30 secondi, generato da un'app dedicata (Aegis, Raivo, Google Authenticator). Metodo 2FA consigliato rispetto all'SMS.Vedi nel lessico → via Aegis o Raivo), accesso SSH al VPS solo tramite chiave (nessuna password), fail2ban per bloccare gli attacchi bruteforce, firewall ufw per limitare le porte aperte (80, 443, 22 solo). Il wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico → collegato a BTCPay : preferire uno xpub×xpub (extended public key)Chiave pubblica estesa. Consente a un wallet in sola lettura di conoscere indirizzi e saldi senza poter firmare. Utilizzata per tracking e osservazione.Vedi nel lessico → watch-only×Watch-onlyModalità in cui un wallet osserva saldi e storico degli indirizzi senza detenere la chiave privata. Usata per monitorare una vault fredda da un dispositivo meno sicuro.Vedi nel lessico → da Sparrow/Specter piuttosto che un wallet hot con seed in BTCPay, il che limita l'esposizione in caso di compromesso del server.