BTCPay Server pour commerçants : déploiement complet

Accepter Bitcoin côté commerçant a longtemps demandé soit de passer par un acquéreur centralisé qui prend une commission de 1 % et garde les fonds en custody×CustodyLa garde des fonds. Voir self-custody et custodial dans la section dédiée plus bas.Voir dans le lexique → (BitPay, Coinbase Commerce des premiers temps), soit du bricolage manuel via un wallet×Wallet (portefeuille)Logiciel ou appareil qui gère vos clés Bitcoin et permet de signer des transactions. Un wallet ne « contient » pas vraiment vos bitcoins, il contient les clés qui prouvent que vous en êtes propriétaire.Voir dans le lexique → Bitcoin générique. BTCPay Server, lancé par Nicolas Dorier en 2017, a changé cette équation : un serveur open source×Open sourceLogiciel dont le code source est public et modifiable par n'importe qui. Garantie d'auditabilité fondamentale dans Bitcoin.Voir dans le lexique →, gratuit, self-hosted, qui génère des invoices, intègre l'e-commerce, et garde les fonds dans un wallet contrôlé par le commerçant.

En 2026, BTCPay Server est porté par la BTCPay Server Foundation et déployé sur des milliers d'instances. Plus de 500 commerçants européens identifiés (restaurants, freelances, e-commerces) l'utilisent en production. L'écosystème compte des intégrations natives WooCommerce, Magento, Shopify, PrestaShop, des terminaux physiques BTCPay POS, et un store d'extensions communautaires (paie en Bitcoin via Bitwage, integration comptable, etc.).

Cet article couvre les deux voies de déploiement, l'intégration aux plateformes e-commerce courantes, le terminal physique BTCPay POS, la décision conversion automatique EUR vs rétention BTC, et la comparaison avec les alternatives tierces non self-hosted (OpenNode, Strike, IBEX Pay).

Deux voies de déploiement : VPS dédié ou intégration Umbrel

Voie 1 : VPS×VPS (Virtual Private Server)Serveur virtuel loué chez un hébergeur (Hetzner, DigitalOcean, OVH), accessible en SSH. Tarif typique 5 à 30 EUR / mois.Voir dans le lexique → dédié BTCPay. La méthode historique. Louer un VPS (DigitalOcean, Hetzner, OVH ou autre, à partir de 10-15 EUR/mois selon spec), choisir Ubuntu 22.04 ou 24.04 LTS, lancer le script BTCPay One-Click (btcpayserver-docker×DockerTechnologie qui empaquette une application et ses dépendances dans un conteneur isolé, lançable d'une commande sur n'importe quel système.Voir dans le lexique →/btcpay-setup.sh). Le script déploie un docker-compose avec Bitcoin Core×Bitcoin CoreImplémentation de référence du logiciel Bitcoin, écrite en C++ et maintenue par une communauté open source. C'est le logiciel que la plupart des nœuds utilisent.Voir dans le lexique → en mode pruned, BTCPay, LND pour Lightning, NBXplorer pour l'indexation, et Nginx pour le reverse proxy. En 30-45 minutes, l'instance est en ligne, accessible via une URL HTTPS de votre choix.

Voie 2 : intégration Umbrel×UmbrelDistribution équivalente pour mini-PC ou Raspberry Pi, avec interface web élégante et store d'applications (BTCPay, mempool.space, Sparrow Server, etc.).Voir dans le lexique →/Start9×Start9 (StartOS)Alternative à Umbrel avec focus sur la souveraineté et la confidentialité. Plus exigeant techniquement, plus rigoureux sur la privacy.Voir dans le lexique →/RaspiBlitz×RaspiBlitzDistribution logicielle clé en main pour transformer un Raspberry Pi en nœud Bitcoin et Lightning. Pionnier du genre, communauté germanophone active.Voir dans le lexique →. Si vous avez déjà un mini-PC×Mini-PC (NUC)Petit ordinateur fanless type Intel NUC, Beelink ou Minisforum. Plus puissant qu'un Raspberry Pi, idéal pour un nœud sérieux avec Lightning et BTCPay.Voir dans le lexique → ou Raspberry Pi×Raspberry PiPetit ordinateur de la taille d'une carte de crédit, à bas prix (60 à 100 EUR). Permet de faire tourner un nœud Bitcoin à domicile.Voir dans le lexique → sous Umbrel ou Start9 pour faire tourner votre nœud×Nœud (node)Ordinateur qui fait tourner le logiciel Bitcoin et participe au réseau en validant les blocs et les transactions. Un « full node » garde une copie complète de la blockchain.Voir dans le lexique →, BTCPay est disponible en app installable depuis le store. Deux clics, quelques minutes d'attente pour télécharger les images Docker, et l'app tourne sur votre Bitcoin Core local. Plus simple que la voie VPS, mais limité à un usage modeste : un Raspberry Pi 5 supporte un commerce moyen mais pas un gros e-commerce avec centaines de commandes par heure.

Premier accès. Naviguer vers l'URL BTCPay, créer un compte admin (premier compte = admin), suivre l'assistant : créer un store (le profil de votre commerce), connecter un wallet×Wallet (portefeuille)Logiciel ou appareil qui gère vos clés Bitcoin et permet de signer des transactions. Un wallet ne « contient » pas vraiment vos bitcoins, il contient les clés qui prouvent que vous en êtes propriétaire.Voir dans le lexique → (xpub×xpub (extended public key)Clé publique étendue. Permet à un wallet en mode lecture seule de connaître les adresses et les soldes sans pouvoir signer. Utilisée pour le tracking et l'observation.Voir dans le lexique → depuis Sparrow/Specter ou seed phrase×Seed phrase (phrase de récupération)Suite de 12 ou 24 mots (souvent en anglais) qui encode votre clé maître. Sauvegarde universelle d'un wallet : avec ces mots, vous pouvez restaurer vos fonds sur n'importe quel logiciel compatible.Voir dans le lexique → pour wallet hot×Wallet hot (hot wallet)Wallet connecté à Internet (mobile, desktop ou en ligne). Pratique pour les petits montants et les paiements rapides, mais plus exposé aux attaques.Voir dans le lexique →), configurer la conversion fiat×Fiat (monnaie fiat)Monnaie étatique à cours légal (euro, franc suisse, dollar), émise par une banque centrale et sans rattachement à un actif physique. Par opposition, Bitcoin a une émission plafonnée à 21 millions d'unités, sans émetteur central.Voir dans le lexique → optionnelle. En 15 minutes, vous pouvez générer votre première invoice et la régler depuis un wallet test.

Intégrations e-commerce : WooCommerce, Magento, Shopify

WooCommerce (WordPress) est l'intégration la plus mature. Le plugin BTCPay for WooCommerce, distribué sur le repository WordPress, ajoute Bitcoin et Lightning comme méthodes de paiement parmi les classiques (carte bancaire Stripe, virement). Configuration : installer le plugin, coller l'URL et la clé d'API×API (Application Programming Interface)Interface qui permet à un programme d'interroger un autre programme ou un service. mempool.space expose une API publique pour interroger la chaîne.Voir dans le lexique → de votre BTCPay Server, lier les stores, activer Bitcoin et Lightning dans WooCommerce. Quinze minutes en tout.

Magento, PrestaShop, OpenCart. Plugins officiels disponibles sur le repo×Repo (repository)Dépôt de code sur GitHub ou équivalent. Le repo Bitcoin Core est github.com/bitcoin/bitcoin.Voir dans le lexique → BTCPay GitHub×GitHubPlateforme web où sont hébergés la plupart des projets open source du monde, dont Bitcoin Core, electrs, BDK, LDK. Permet de voir le code, l'historique des modifications, et de proposer des contributions.Voir dans le lexique →, configuration similaire. Pour Magento 2, le plugin BTCPay-for-magento2 est maintenu par la communauté. Shopify est un cas particulier : Shopify ne permet pas de plugin de paiement crypto directement (politique Shopify), il faut passer par une intégration tierce (Coincharge ou similaire) qui reroute vers BTCPay. Plus de friction mais possible.

Plateformes custom (boutique PHP×PHPLangage de programmation côté serveur utilisé par CapBitcoin. Tourne sur la plupart des hébergeurs mutualisés.Voir dans le lexique →, Node.js, Django, etc.). BTCPay expose une API REST complète documentée sur docs.btcpayserver.org. Créer une invoice via POST /api/v1/stores/{storeId}/invoices, recevoir un webhook quand le paiement est confirmé, mettre à jour la commande dans son backoffice. Le développement prend une journée pour un dev backend Bitcoin-familier, plus quelques jours pour intégrer proprement avec gestion d'erreurs et retours.

Terminal physique BTCPay POS pour boutique

Pour les commerces physiques (restaurant, café, boutique, atelier), BTCPay POS est une interface tactile dédiée qui transforme une tablette ou un téléphone en terminal de caisse Bitcoin. Disponible nativement dans BTCPay Server : Apps → POS App. Configurer une liste d'articles avec prix EUR (ou CHF, etc.), choisir l'affichage (catégories ou liste plate), activer.

Utilisation : l'employé ouvre BTCPay POS sur la tablette (URL bookmarquée), sélectionne les articles vendus, le total s'affiche, clique « Pay with Bitcoin ». Un QR code×QR code (code QR)Code-barres en deux dimensions, omniprésent dans Bitcoin : adresses, invoices Lightning, URI de paiement. Toujours vérifier le montant et l'adresse décodés avant de valider.Voir dans le lexique → apparaît à l'écran, le client le scanne avec son wallet×Wallet (portefeuille)Logiciel ou appareil qui gère vos clés Bitcoin et permet de signer des transactions. Un wallet ne « contient » pas vraiment vos bitcoins, il contient les clés qui prouvent que vous en êtes propriétaire.Voir dans le lexique → Lightning (Phoenix, Muun, Wallet of Satoshi×Satoshi (sat)La plus petite unité de bitcoin. 1 BTC = 100 millions de satoshis. Nom inspiré du créateur. En 2026, parler en sats devient courant à mesure que le prix d'un BTC s'élève.Voir dans le lexique →). Confirmation visuelle et sonore dans BTCPay POS dès que le paiement est confirmé Lightning (typique : 2 secondes). L'argent est dans votre BTCPay wallet, lui-même contrôlé par votre seed phrase×Seed phrase (phrase de récupération)Suite de 12 ou 24 mots (souvent en anglais) qui encode votre clé maître. Sauvegarde universelle d'un wallet : avec ces mots, vous pouvez restaurer vos fonds sur n'importe quel logiciel compatible.Voir dans le lexique → ou multisig×Multisig (multi-signature)Configuration où une transaction doit être signée par plusieurs clés indépendantes pour être valide (par exemple 2 clés parmi 3). Réduit le risque qu'un seul vol de clé fasse perdre les fonds.Voir dans le lexique →.

Hardware. N'importe quelle tablette Android ou iPad de 8-10 pouces avec un navigateur récent suffit. Investissement initial : 200-400 EUR pour une tablette correcte et son support de caisse. Connexion : WiFi local stable. Plan B en cas de panne BTCPay : un wallet Lightning mobile classique sur smartphone (Phoenix avec adresse Lightning statique). En 2026, c'est devenu un setup standard pour les commerces qui acceptent sérieusement Bitcoin.

Conversion automatique EUR vs rétention BTC

Décision stratégique pour un commerçant : quand un paiement Bitcoin arrive, faut-il le garder en BTC ou le convertir automatiquement en EUR pour stabiliser la trésorerie ? Les deux options sont valides selon le profil, la fiscalité et l'appétit pour le risque.

Rétention BTC. Le paiement arrive en sats dans votre BTCPay wallet×Wallet (portefeuille)Logiciel ou appareil qui gère vos clés Bitcoin et permet de signer des transactions. Un wallet ne « contient » pas vraiment vos bitcoins, il contient les clés qui prouvent que vous en êtes propriétaire.Voir dans le lexique → et y reste. Avantages : exposition à la hausse Bitcoin (intéressant si vous avez une thèse haussière), pas de coût de conversion, contrôle total. Inconvénients : volatilité (peut perdre 30 % en quelques semaines), gestion fiscale plus complexe (chaque vente future déclenche une plus-value×Plus-value, moins-valueGain (ou perte) réalisé à la cession d'un actif : différence entre prix de vente et prix d'acquisition. En France, les plus-values crypto des particuliers relèvent du PFU à 30 % ; les moins-values s'imputent la même année.Voir dans le lexique → à calculer), trésorerie en monnaie volatile pour des coûts en EUR. Plus adapté à une petite proportion (10-30 %) du chiffre d'affaires, gardée volontairement comme treasury Bitcoin.

Conversion automatique. BTCPay Server peut être configuré avec un connecteur exchange×Exchange (plateforme d'échange)Service qui permet d'acheter, vendre et échanger des cryptos contre des monnaies fiat. Exemples : Kraken, Coinbase, Bitstamp, Bitvavo. La plupart sont custodial.Voir dans le lexique → (Kraken, Bitfinex via API×API (Application Programming Interface)Interface qui permet à un programme d'interroger un autre programme ou un service. mempool.space expose une API publique pour interroger la chaîne.Voir dans le lexique →) qui convertit chaque paiement reçu en EUR instantanément. Avantages : trésorerie stable en EUR, comptabilité plus simple, élimination du risque volatilité. Inconvénients : commission exchange (typiquement 0,1-0,3 %), exposition à la défaillance de l'exchange (ne pas y laisser plus que nécessaire). Plus adapté pour la majorité du flux commercial. Configuration recommandée 2026 : 80-90 % conversion auto, 10-20 % rétention BTC.

Alternatives tierces : OpenNode, Strike, IBEX Pay

Si self-hoster BTCPay est trop technique ou trop coûteux pour un démarrage, plusieurs services tiers proposent une expérience similaire en custodial×CustodialModèle dans lequel un tiers (exchange, broker, néobanque) détient vos clés privées à votre place. Vous avez une créance, pas un bitcoin. « Not your keys, not your coins ».Voir dans le lexique → : ils opèrent l'infrastructure, vous payez une commission de service. Trois acteurs dominent en 2026.

OpenNode (USA, depuis 2018). Service custodial complet, intégrations e-commerce identiques à BTCPay (WooCommerce, Magento, Shopify), conversion automatique en USD/EUR proposée. Commission typique : 1 % par transaction réussie, gratuité jusqu'à un certain seuil. Avantage : zéro infrastructure à gérer. Inconvénient : trust dans OpenNode (ils tiennent vos fonds entre paiement et retrait, ont une licence MSB américaine donc reporting fiscal IRS×IRSAdministration fiscale américaine. Pour les expatriés américains, le reporting crypto à l'IRS reste obligatoire même hors USA.Voir dans le lexique → possible).

Strike (USA, Jack Mallers, depuis 2019). Plus orienté grand public et Lightning Address×Lightning AddressAdresse de type email (alice@strike.me) qui permet de recevoir des paiements Lightning sans générer une facture à chaque fois.Voir dans le lexique → (paiement par adresse email-like type alice@strike.me). Commission faible (0,3 % ou moins selon volume). Excellent pour les freelances qui facturent à l'international, et pour les commerçants américains. Moins répandu en Europe pour cause de couverture géographique partielle. IBEX Pay (Salvador, depuis 2021). Focus Amérique latine et Europe. Custodial avec offre Lightning native, commissions compétitives. Tableau de bord commerçant plus orienté business que technique. Décision en 2026 : BTCPay pour qui peut self-héberger (souveraineté maximale), OpenNode/Strike/IBEX pour qui démarre et veut simple.

Maintenance, sécurité, sauvegarde

Maintenance. Une instance BTCPay self-hosted demande un peu de soin. Mise à jour : un script btcpay-update.sh tourne les images Docker×DockerTechnologie qui empaquette une application et ses dépendances dans un conteneur isolé, lançable d'une commande sur n'importe quel système.Voir dans le lexique → vers les dernières versions, à exécuter tous les 1-2 mois. Surveillance : BTCPay log les erreurs, à consulter occasionnellement via SSH×SSH (Secure Shell)Protocole pour se connecter à distance à un serveur en ligne de commande, de manière chiffrée.Voir dans le lexique →. Espace disque : un nœud×Nœud (node)Ordinateur qui fait tourner le logiciel Bitcoin et participe au réseau en validant les blocs et les transactions. Un « full node » garde une copie complète de la blockchain.Voir dans le lexique → Bitcoin pruné consomme ~50 Go, à surveiller. Sauvegarde : exporter régulièrement les configurations (Settings → Maintenance → Export), stocker hors du VPS×VPS (Virtual Private Server)Serveur virtuel loué chez un hébergeur (Hetzner, DigitalOcean, OVH), accessible en SSH. Tarif typique 5 à 30 EUR / mois.Voir dans le lexique → pour pouvoir reconstruire en cas de perte.

Sécurité. Les bonnes pratiques : 2FA×2FA (Two-Factor Authentication)Authentification à deux facteurs. En plus du mot de passe, un second élément est exigé pour se connecter (code par TOTP, SMS, clé physique). Standard sur toutes les plateformes sérieuses.Voir dans le lexique → activé sur le compte admin (TOTP×TOTP (Time-based One-Time Password)Code à 6 chiffres qui change toutes les 30 secondes, généré par une app dédiée (Aegis, Raivo, Google Authenticator). Méthode 2FA recommandée par rapport au SMS.Voir dans le lexique → via Aegis ou Raivo), accès SSH au VPS uniquement par clé (pas de mot de passe), fail2ban pour bloquer les attaques bruteforce, ufw firewall pour limiter les ports ouverts (80, 443, 22 uniquement). Le wallet×Wallet (portefeuille)Logiciel ou appareil qui gère vos clés Bitcoin et permet de signer des transactions. Un wallet ne « contient » pas vraiment vos bitcoins, il contient les clés qui prouvent que vous en êtes propriétaire.Voir dans le lexique → connecté à BTCPay : préférer un xpub×xpub (extended public key)Clé publique étendue. Permet à un wallet en mode lecture seule de connaître les adresses et les soldes sans pouvoir signer. Utilisée pour le tracking et l'observation.Voir dans le lexique → watch-only×Watch-onlyMode dans lequel un wallet observe les soldes et l'historique d'adresses sans détenir la clé privée. Utilisé pour suivre une vault froide depuis un appareil moins sûr.Voir dans le lexique → depuis Sparrow/Specter plutôt qu'un hot wallet avec seed dans BTCPay, ce qui limite l'exposition en cas de compromis serveur.