Béni-Christ
Bitcoin pour les entreprises4.7(169)
Débutant
Apprenez les bases du paiement et de la trésorerie pour faire passer votre entreprise au bitcoin
BTCPay Server est un logiciel libre et open source créé par Nicolas Dorier permettant d’accepter des paiements en bitcoin sans intermédiaire. Conçu pour offrir autonomie et souveraineté financière, il s’installe sur son propre serveur et assure la gestion complète des transactions, depuis la facturation jusqu’à la validation des paiements on-chain ou via le Lightning Network, et la comptabilité. Il s'intègre facilement à des sites e-commerce (WooComerce, Shopify, etc.) ou peut être utilisé comme un terminal de paiement pour les commerces physiques (POS).
BTCPay Server constitue sans doute la solution la plus aboutie pour les commerçants souhaitant accepter le bitcoin. C’est le logiciel le plus complet et le plus robuste en matière de sécurité, de souveraineté et de confidentialité. En contrepartie, il est également le plus complexe à installer et à maintenir. Il existe également des alternatives plus simples : certaines sont entièrement custodiales, comme OpenNode, tandis que d’autres proposent un compromis intéressant entre simplicité d’utilisation et souveraineté, à l’image de Swiss Bitcoin Pay :
Ce tutoriel a justement pour objectif de vous guider pas à pas dans l’installation, la configuration et l’utilisation de BTCPay Server, afin de vous permettre de déployer une infrastructure de paiement sécurisée, indépendante et conforme à l’éthos de Bitcoin.
Spécificités de BTCPay Server
Les solutions de point de vente Bitcoin centralisées, comme OpenNode par exemple, offrent une grande simplicité d’utilisation, mais reposent sur une entreprise tierce puisqu’elles ne peuvent pas être auto-hébergées et sont, la plupart du temps, propriétaires. Si elles facilitent la mise en place des paiements, elles impliquent des frais de commission et exposent leurs utilisateurs à davantage de risques qu’une solution comme BTCPay Server, aussi bien en matière de garde des fonds que de confidentialité.
BTCPay Server s’adresse aux commerçants en ligne ou physiques, aux associations et organismes à but non lucratif désireux de recevoir des dons en bitcoins. Il constitue également une solution idéale pour les porteurs de projets ainsi que pour les développeurs souhaitant obtenir un soutien direct de leur communauté.
Les spécificités de BTCPay Server résident dans :
- son autonomie complète,
- l’absence de procédure KYC,
- le contrôle intégral des fonds,
- la suppression des frais de plateforme.
En devenant votre propre processeur de paiement, vous éliminez toute dépendance à un tiers centralisé entre vous et vos clients. Vous pouvez ainsi accepter des paiements directement en bitcoins et générer des factures de paiement. Cela garantit que ni vous ni votre entreprise ne pourrez être bannis par qui que ce soit. Vous jouez à la fois le rôle de banque et de processeur de paiement, sans avoir à verser de commissions à un intermédiaire pour chaque transaction.
Les frais liés aux transactions on-chain demeurent, mais ils peuvent être réduits grâce à l’utilisation du réseau Liquid ou Lightning.
À cela s’ajoutent :
- Personnalisation complète de l’interface et des factures ;
- Prise en charge native de Tor, garantissant une confidentialité accrue ;
- Prise en charge du crowdfunding, du POS et des boutons de paiement ;
- Compatibilité avec de nombreuses devises ;
- Paiements Bitcoin directs et pair-à-pair ;
- Contrôle complet sur vos clés privées ;
- Confidentialité améliorée ;
- Sécurité renforcée ;
- Logiciel auto-hébergé ;
- Prise en charge de SegWit et du réseau Lightning ;
- Portefeuille interne, basé sur les nœuds, avec intégration de portefeuilles matériels.
Installation et configuration de BTCPay Server
Choisir son mode d’hébergement
BTCPay Server peut être installé de différentes manières. Selon vos besoins et vos ressources, trois options principales s’offrent à vous :
- BTCPay Server hébergé par un tiers : vous utilisez une plateforme qui héberge le service pour vous. C’est simple, mais généralement payant.
- BTCPay Server auto-hébergé sur un serveur cloud (par exemple via btcpayprovider, Bitcoin People ou tout autre fournisseur). C’est la solution recommandée pour la plupart des commerçants débutants.
- BTCPay Server installé sur votre propre matériel (en local) : sur un ordinateur, un mini-PC ou un Umbrel. Cette méthode est plus technique, mais offre une indépendance totale.
Pour un commerçant débutant, le déploiement sur un serveur cloud est le meilleur compromis entre autonomie, simplicité et sécurité, sans devoir gérer toute l’infrastructure technique.
Plusieurs hébergeurs permettent un déploiement rapide de BTCPay Server. Parmi eux, Voltage s’impose comme une solution de référence pour les utilisateurs souhaitant une infrastructure fiable, professionnelle et souveraine.
Créer une instance BTCPay Server sur Voltage
Voltage est une plateforme d’hébergement Bitcoin et Lightning clé en main qui permet de déployer instantanément votre propre BTCPay Server, sans configuration complexe ni maintenance du serveur.
Rendez-vous sur le site officiel de Voltage.
Créez un compte utilisateur avec une adresse e-mail valide et un mot de passe fort.
Voltage offre un essai gratuit de 7 jours. À noter qu’après nos 7 jours d’essai gratuit, vous serez invité à souscrire à un abonnement fixe de 25 $ par mois afin de continuer à garder vos nœuds actifs.
Une fois votre compte Voltage créé et votre première connexion effectuée, vous serez redirigés vers la page d’accueil, qui présente deux sections principales :
- Une section Infrastructure qui permet de gérer les nœuds Lightning, Bitcoin Core, BTCPay Server et d’autres services Bitcoin dans le cloud ;
- et une section Paiements qui vous permet d’accéder à l’API Lightning de Voltage pour intégrer des paiements Bitcoin dans des applications personnalisées.
Pour déployer votre instance BTCPay Server, cliquez sur Accéder à l’infrastructure. C’est ici que vous pourrez créer, gérer et superviser l’ensemble de vos services, dont votre nœud Bitcoin et votre serveur BTCPay.
Créer un groupe
Avant de pouvoir déployer un service, la plateforme vous invitera à créer un groupe. Un groupe (workspace) est un espace de travail qui regroupe tous vos services Bitcoin et Lightning (par exemple un nœud, un BTCPay Server, un explorateur, etc.). C’est un peu comme un dossier qui contient vos différents projets.
Dans le cadre de notre tutoriel, le groupe que nous avons créé portera le nom Genesis. Vous pouvez ajouter une image de profil si vous le souhaitez. Une fois que c'est fait, cliquez sur le bouton Créer. Vous pouvez inviter d'autres utilisateurs à rejoindre le groupe, voire changer le nom du groupe si vous le souhaitez.
Sur la page d’accueil du groupe, plusieurs options apparaissent :
- Lightning Nodes : pour déployer un nœud Lightning complet (LND) ;
- Bitcoin Core Nodes : pour lancer un nœud Bitcoin complet ;
- BTCPay Server : pour héberger une instance BTCPay prête à l’emploi ;
- Nostr Accounts : pour gérer des identités Nostr.
Activez la double authentification (2FA) pour sécuriser votre compte et vos services (le bouton est visible en rouge si elle est désactivée).
Cliquez sur BTCPay Server parmi les options, puis sur Launch a BTCPay Store.
Voltage vous proposera alors de créer et configurer votre instance BTCPay Server en choisissant un nom de service (1) et en activant selon votre convenance les paiements Lightning (2).
Vous aurez forcément besoin d'un nœud Lightning, si vous décidez d'accepter les paiements Lightning.
Si vous n’avez pas encore de nœud Bitcoin ou Lightning, Voltage vous proposera d’en créer un automatiquement.
Cliquez sur Créer un nœud Lightning (3) .
Une fois sur l'interface de création de votre nœud, vous aurez à choisir entre le plan standard et le plan professionnel.
Vous pouvez créer un nœud réel (Mainnet) ou de test (Testnet). Cliquez ensuite sur le bouton Continuer.
Pour ce tutoriel, utilisons le plan standard. Entrez le nom du nœud, un mot de passe puis appuyez sur le bouton Create.
Après quelques instants, votre nœud sera opérationnel et vous pourrez ouvrir gratuitement un canal avec une capacité de réception de 500 000 sats.
Un peu plus en bas à droite, vous avez toutes les informations concernant votre nœud !
Maintenant que nous avons notre nœud Lightning qui tourne, retournons à l'installation de notre serveur BTCPay. À présent, vous pouvez cliquer sur le bouton Create BTCPay.
Une page s’ouvrira avec vos identifiants par défaut, accompagnée d’un message vous invitant à modifier le mot de passe initial qui vous est attribué. Une fois cette étape terminée, cliquez sur le bouton Login Now (Se connecter) pour accéder à votre interface.
Ça y est ! Votre serveur BTCPay est prêt à être utilisé. Vous serez directement redirigé vers la page de connexion de votre serveur BTCPay.
Une fois connecté, configurez votre premier magasin (Store) :
-
Donnez-lui un nom.
-
Choisissez la devise par défaut (EUR, USD, CFA, etc.).
-
Sélectionnez un fournisseur de taux de change (ex. CoinGecko).
Ensuite, vous serez redirigé vers le tableau de bord de votre magasin. Sur l'interface du tableau de bord, vous allez constater que le bouton Créer votre boutique est marqué en vert, puisque l'étape est déjà franchie.
Un peu plus bas nous avons le bouton Configurer un portefeuille et Configurer un nœud Lightning. Dans notre cas, nous nous sommes déjà connectés à un nœud Lightning qui tourne sur voltage. Donc on aura plus à le faire ici.
Nous allons donc passer à la configuration d’un portefeuille. Cliquez sur le bouton Configurer un portefeuille.
Puisque nous débutons la prise en main de BTCPay Server, nous allons connecter un portefeuille existant. Appuyez donc sur Connecter un portefeuille existant.
Vous devez ensuite choisir votre méthode d’importation. Parmi les options disponibles, sélectionnez Entrer la clé publique étendue.
En reliant un portefeuille existant, vous pouvez recevoir vos paiements directement sur ce portefeuille externe, sans que le serveur BTCPay ait accès à votre clé privée. Ainsi, même en cas de piratage du serveur ou de compromission de la clé publique (
xpub), un attaquant pourrait consulter l’historique de vos transactions, mais il lui serait impossible d’accéder à vos fonds.Une fois que vous cliquez sur le bouton Entrer la clé publique étendue, vous serez redirigé vers la page où vous devez fournir cette clé.
Allons maintenant récupérer la clé publique étendue.
Connecter un portefeuille Bitcoin
Pour recevoir vos paiements, vous devez connecter un portefeuille Bitcoin à votre magasin. Pour cela, plusieurs options s’offrent à vous :
-
Portefeuille matériel (Ledger, Trezor, Coldcard...) ;
-
Portefeuille logiciel (Blockstream App, Ashigaru, Electrum, Sparrow...)
-
Portefeuille interne BTCPay Server (non recommandé, car il est moins sécurisé et expose davantage vos fonds en cas de piratage du serveur).
Dans ce tutoriel, nous allons utiliser un portefeuille logiciel, plus accessible pour une première configuration. Vous pouvez choisir parmi de nombreuses applications compatibles : Electrum, Phoenix, Zeus, Muun, etc.
Pour la démonstration, nous utiliserons Electrum. Ouvrez Electrum, cliquez sur Portefeuille, puis sur Informations :
Ensuite, copiez la clé publique maîtresse (xpub).
Une fois la clé publique maîtresse copiée, collez-la dans le champ prévu à cet effet sur la page BTCPay Server.
Après vérification, vous serez redirigé vers le tableau de bord de votre magasin.
Générer un Point de Vente (PoS)
Une fois votre boutique et votre portefeuille configurés, vous pouvez désormais mettre en place un Point de Vente (PoS) pour commencer à recevoir des paiements Bitcoin directement de vos clients.
Cette fonctionnalité intégrée à BTCPay Server est idéale pour les commerçants, artisans, restaurateurs ou prestataires de services souhaitant accepter le Bitcoin sans site web ni compétences techniques particulières.
À quoi sert le Point de Vente ?
Le PoS est une interface de caisse simplifiée qui agit comme un terminal de paiement Bitcoin.
Il vous permet de :
Il vous permet de :
- Créer un menu de produits ou services avec prix fixes.
- Générer une facture instantanée avec QR code à scanner.
- Partager une URL de paiement accessible sur smartphone, tablette ou ordinateur.
En d’autres termes, le PoS transforme votre BTCPay Server en une interface de vente directe, où chaque paiement est reçu dans votre propre portefeuille Bitcoin, sans intermédiaire.
Configurer le PoS
Dans le tableau de bord BTCPay, cliquez sur PLUGINS, puis sur Point de vente.
Cliquez ensuite sur Créer une nouvelle application PoS. Cette action permet d’ajouter une nouvelle application à votre boutique BTCPay, comme si vous installiez un mini site de vente interne.
Une page s’ouvre pour la création de votre application. Définissez un nom de l’application : il s’agit d’un nom interne, visible uniquement depuis votre tableau de bord (ex. : Boutique Chaussures).
Cliquez sur Créer pour valider.
Une fois créée, vous serez redirigé vers la page de configuration détaillée du Point de Vente.
Personnaliser votre interface de vente
Sur cette page, vous pouvez définir les éléments essentiels de votre PoS :
-
Nom de l’application (nom interne de gestion, modifiable à tout moment).
-
Titre d’affichage (ce que verront vos clients en haut de la page).
-
Style du point de vente (le mode Description convient aux services ou prestations comme une coupe de cheveux ou un repas, tandis que le mode Catalogue de produits est idéal pour les boutiques proposant plusieurs articles).
-
Devise d’affichage (choisissez XOF, EUR ou USD selon vos prix habituels).
-
Liste des articles ( ici ajoutez vos produits, descriptions et prix).
Sauvegarder et tester votre PoS
Lorsque vous avez terminé la configuration, cliquez sur Enregistrer pour sauvegarder vos paramètres, puis sur Voir pour afficher un aperçu de votre PoS.
Vous verrez une page présentant vos produits, chaque bouton correspondant à un article ou service.
Dès qu’un client sélectionne un produit :
-
BTCPay génère automatiquement une facture Bitcoin ou Lightning.
-
Un QR code s’affiche à l’écran.
-
Le client peut scanner et payer directement avec son portefeuille Bitcoin.
Résultat final
Vous disposez désormais d’un Point de Vente Bitcoin complet que vous pouvez :
-
Ouvrir depuis un smartphone ou une tablette dans votre boutique ;
-
Afficher sur un écran pour que le client scanne ;
-
Ou partager via une URL publique, comme une page de commande simplifiée.
À chaque paiement, le montant est automatiquement crédité sur votre propre portefeuille BTCPay, sans intermédiaire ni frais tiers.
Votre PoS devient ainsi un terminal de paiement Bitcoin autonome.
Votre PoS devient ainsi un terminal de paiement Bitcoin autonome.
Utilisation au quotidien
Avant d’encaisser de vrais paiements, il est recommandé d’effectuer un test pour vérifier que tout fonctionne correctement.
Tester un paiement
-
Créez une facture depuis votre interface PoS (par exemple, un produit à 1 satoshi ou une petite somme).
-
Scannez le QR code affiché à l’écran à l’aide d’un portefeuille Bitcoin ou Lightning (comme Phoenix, Muun ou Wallet of Satoshi).
-
Validez le paiement dans votre portefeuille : la transaction est envoyée instantanément.
-
Retournez dans BTCPay Server : la facture apparaîtra comme Payée dans la liste.
Félicitations ! Votre Point de Vente est désormais fonctionnel. Vous pouvez commencer à recevoir des paiements Bitcoin de vos clients, simplement, rapidement et sans intermédiaire.
Créer une facture pour un client
Dans le menu Factures, cliquez sur Nouvelle facture.
Entrez le montant et la devise locale (BTCPay calcule automatiquement l’équivalent en BTC), ainsi que les autres informations concernant le produit.
Partagez le QR code ou l’URL avec le client.
Suivre les paiements reçus
Toujours dans le menu Factures, vous verrez la liste de toutes vos transactions.
Les statuts possibles sont :
Les statuts possibles sont :
-
En attente : paiement non encore confirmé.
-
Réglée : paiement confirmé.
-
Expirée : facture non réglée dans le délai imparti.
Rembourser un client
Dans le menu Factures, sélectionnez la facture à rembourser.
Cliquez sur Rembourser et saisissez l’adresse Bitcoin fournie par le client.
Rapports et exportation des données
BTCPay Server permet d’exporter vos transactions (au format CSV ou Excel). C’est très pratique pour votre comptabilité et votre suivi de caisse.
Dans le menu Rapport, cliquez sur Exporter : toutes vos transactions seront enregistrées dans un fichier CSV que vous pourrez ensuite consulter localement.
Sécurité et Bonnes pratiques
L’autonomie que confère BTCPay Server (la pleine souveraineté sur vos fonds) constitue une véritable force. Mais cette liberté s’accompagne d’une responsabilité plus grande en matière de sécurité. En gérant vous-même vos paiements, vous endossez le rôle de votre propre banque. Il est donc impératif d’adopter de bonnes pratiques pour protéger vos fonds, vos données et votre infrastructure. Voici les principaux points à prendre en considération.
Sécuriser l’accès à votre serveur
- Utilisez un mot de passe fort : combinez majuscules, minuscules, chiffres et caractères spéciaux. Évitez toute réutilisation d’un mot de passe existant.
- Activez l’authentification à deux facteurs (2FA) pour accéder à votre interface BTCPay.
- Mettez régulièrement à jour votre système d’exploitation, votre instance BTCPay Server et vos dépendances (Docker, nœud Bitcoin, nœud Lightning...). Les mises à jour corrigent souvent des vulnérabilités de sécurité.
Gérer et sauvegarder les clés privées
- Sauvegardez vos clés privées et vos seedphrases hors ligne, sur un support physique (papier ou métal).
- Utilisez de préférence un portefeuille matériel (hardware wallet).
- Conservez plusieurs copies de vos sauvegardes, dans des lieux physiques distincts et protégés.
Sécuriser les paiements et la confidentialité
- Utilisez le réseau Tor ou un VPN pour masquer l’adresse IP de votre serveur et protéger votre vie privée.
- Désactivez les ports non nécessaires sur votre serveur et limitez les connexions SSH aux seules adresses de confiance.
- Activez le HTTPS (certificat SSL) pour toutes les connexions à votre interface web BTCPay.
- Ne partagez jamais votre interface d’administration avec du personnel non formé à la gestion de portefeuilles Bitcoin.
Mettre en place de bonnes pratiques pour le réseau Lightning
Votre boutique est connectée à un nœud Lightning hébergé sur Voltage, ce qui simplifie considérablement la gestion technique du réseau. Néanmoins, il reste important d’adopter de bonnes pratiques de suivi et de sécurité :
- Sauvegardez les identifiants et clés d’accès API de votre nœud Voltage (elles permettent à BTCPay de se connecter).
- Protégez votre compte Voltage avec une authentification à deux facteurs et un mot de passe fort.
- Surveillez l’état du nœud et des canaux depuis votre tableau de bord Voltage : cela vous aide à repérer toute anomalie ou désynchronisation.
- Évitez de partager vos identifiants d’API ou de les exposer publiquement (par exemple dans le code du site).
- En cas de migration, reconfigurez simplement le lien entre BTCPay et Voltage : aucun canal n’a besoin d’être fermé manuellement.
Grâce à Voltage, vous bénéficiez d’une infrastructure sécurisée, hautement disponible et automatiquement sauvegardée, tout en gardant la pleine souveraineté sur vos paiements Lightning.
Organiser et structurer des procédures internes
- Définissez une politique claire de gestion des accès : qui peut créer une facture, consulter les paiements, accéder au nœud, etc.
- Consignez vos procédures de sauvegarde et de restauration afin de pouvoir réagir rapidement en cas d’incident.
- Testez régulièrement la restauration de vos sauvegardes pour vous assurer qu’elles fonctionnent correctement.
- Formez votre personnel ou vos collaborateurs à la sécurité opérationnelle de base : vigilance face au phishing, utilisation de mots de passe sécurisés, respect de la confidentialité.
Superviser et établir une maintenance continue
- Surveillez en permanence l’activité de votre serveur via des outils de logs ou de monitoring.
- Planifiez une revue de sécurité périodique : vérifiez les mises à jour, les accès, les sauvegardes et la cohérence des transactions.
Félicitations! Vous êtes à la fin de ce tutoriel. Vous pouvez maintenant prendre en main BTCPay Server tout seul pour vous faciliter la tâche dans la gestion de votre boutique.
Pour aller plus loin, je vous recommande de suivre notre formation complète consacrée à l’intégration de Bitcoin au sein de votre entreprise :
Cela a-t-il bien fonctionné pour vous ?
9
0
Auteur
Ce tutoriel a été écrit par Béni-Christ
Vous pouvez dire merci en donnant un pourboire au professeur.
Bonjour ! Je suis un développeur frontend, avec un esprit curieux et une passion pour l'apprentissage. Depuis 2024, je m'intéresse à la finance, à la blockchain et au Bitcoin. Maintenant, je veux passer à l'étape suivante : partager mes connaissances et contribuer à des projets qui relient la technologie et l'éducation.
developmentsoftwareguides
Crédits
Ce tutoriel a été relu par bened45 & therancedognon-max
2/3Statut de relecture
Même si cette page est dans sa langue d'origine, une relecture humaine est toujours nécessaire pour garantir son exactitude.
bened45therancedognon-max0 satsChaque élément de contenu sur la plateforme est le produit d'un effort collaboratif : chaque leçon, traduction et révision est rendue possible grâce au travail des contributeurs. C'est pour cette raison que nous sommes toujours à la recherche de correcteurs qui peuvent examiner notre contenu dans un grand nombre de langues. Si vous souhaitez participer au processus de relecture, veuillez nous rejoindre dans notre groupe Telegram et consulter notre tutoriel. Nous vous rappelons que ce contenu est open-source - sous licence CC BY-SA - et peut donc être partagé et utilisé librement, à condition que la source originale soit reconnue.