Ce qu’est BTCPay Server
BTCPay Server est un logiciel gratuit qui permet d’accepter des bitcoins quand on est une entreprise, une association ou un indépendant. Il crée des factures et des pages de paiement, fait fonctionner un écran de caisse pour le comptoir d’un magasin, et se branche sur les boutiques en ligne. Les paiements arrivent directement dans votre propre portefeuille. Selon son guide utilisateur, il "does not hold funds as a payment intermediary" (ne détient pas de fonds en tant qu’intermédiaire de paiement).
Il est open source sous licence MIT et vous le faites tourner vous-même. Le projet affirme ne pas être une entreprise, et la BTCPay Server Foundation, qui le soutient, est une organisation à but non lucratif financée par des dons. BTCPay ne facture rien. Sa FAQ dit : "We do not charge you anything. However, to run it, you should host it." (Nous ne vous facturons rien. Mais pour l’utiliser, vous devez l’héberger.) Vos coûts sont le serveur et les frais de réseau habituels.
Ce guide a été vérifié avec la version 2.4.7, publiée le 29 octobre 2026. C’était une version de sécurité qui corrigeait 85 problèmes, et le projet recommande vivement de mettre à jour, en particulier sur les serveurs partagés entre plusieurs commerçants.
Si vous voulez seulement être payé de temps en temps, un portefeuille ordinaire suffit. BTCPay sert quand vous avez besoin de factures liées à des commandes, d’une caisse, de remboursements et d’une comptabilité.
BTCPay Server ↗ · Version 2.4.7 de BTCPay Server ↗
Où le faire tourner
BTCPay a besoin d’un nœud Bitcoin et d’une machine qui reste en ligne. Il existe trois solutions courantes.
- Un serveur que vous louez. L’installation officielle utilise Docker sur un serveur loué, avec votre propre nom de domaine pour une adresse web sécurisée. Selon les recommandations du projet, le strict minimum est de 4 Go de mémoire, 2 cœurs de processeur et 50 Go de stockage SSD avec un nœud élagué, en général pour environ $20 par mois ou moins. LunaNode propose une installation en un clic pour environ $10 par mois.
- Votre nœud à domicile. BTCPay est une application sur Umbrel et Start9. La communauté BTCPay indique ne pas pouvoir assurer l’assistance pour ces installations. Umbrel prévient que les boutiques en ligne comme Shopify ou WordPress ne peuvent pas joindre un serveur à domicile si vous ne configurez pas un DNS dynamique.
- Le serveur de quelqu’un d’autre. Certaines personnes font tourner BTCPay et laissent d’autres y ouvrir des boutiques. Lisez les avertissements ci-dessous avant d’en utiliser un.
Le nœud Bitcoin met entre un et cinq jours à se synchroniser la première fois. Dès que le serveur est en place, créez votre compte. Le premier compte enregistré devient l’administrateur du serveur. Si quelqu’un d’autre vous a devancé, la documentation conseille de recommencer avec un nouveau serveur.
BTCPay : options de déploiement ↗ · BTCPay : déploiement Docker ↗
Utiliser le serveur de quelqu’un d’autre
Un hébergeur tiers est bon marché et rapide, et la documentation de BTCPay est franche sur la contrepartie : vous faites confiance au propriétaire du serveur.
- Un hébergeur n’a jamais besoin de votre clé privée. La documentation dit que si un hébergeur vous en demande une ou en crée une pour vous, "be sure it's a scam" (soyez sûr que c’est une arnaque).
- Connectez un portefeuille que vous détenez déjà, par sa clé publique, jamais un portefeuille chaud. Un hébergeur malhonnête pourrait tout de même faire tourner un logiciel modifié qui remplace votre clé par la sienne, si bien que les paiements suivants iraient chez lui. Vérifiez régulièrement que les paiements arrivent dans votre propre portefeuille.
- L’hébergeur peut voir comment vous utilisez votre boutique. Par défaut, les boutiques d’un serveur partagé ne peuvent ni utiliser le nœud Lightning du serveur ni créer de portefeuilles chauds.
La documentation suggère les hébergeurs tiers pour tester et apprendre, pas pour des paiements importants ou fréquents.
BTCPay : hébergement par un tiers ↗
Créer une boutique
- Choisissez Create account et inscrivez-vous.
- Sur Create your first store, saisissez un Name, une Default currency pour vos prix et une Preferred Price Source, c’est-à-dire le taux de change que BTCPay utilise pour les convertir. La source suggérée convient pour commencer. Choisissez Create Store.
- Le tableau de bord indique ce qu’il reste à faire : Set up a wallet et, si vous le souhaitez, Set up a Lightning node.
Connecter un portefeuille
Choisissez Set up a wallet. BTCPay propose deux voies.
Connect an existing wallet est la plus sûre. BTCPay n’obtient que la clé publique de votre portefeuille, ce qui lui permet de créer une nouvelle adresse pour chaque facture, mais pas de dépenser. La FAQ du projet le formule ainsi : "Even if your server gets hacked, your funds from the on-chain transactions are always safe." (Même si votre serveur est piraté, vos fonds issus des transactions sur la chaîne restent toujours en sécurité.) Les options d’importation sont :
- Connect hardware wallet, avec l’application Vault de BTCPay sur votre ordinateur et l’appareil branché.
- Import wallet file, un fichier exporté depuis un portefeuille comme Sparrow.
- Enter extended public key, la clé collée à la main.
- Scan wallet QR code, que BTCPay indique pour BlueWallet, Passport et d’autres.
- Enter wallet seed, marquée Not recommended. Ne tapez jamais vos mots de récupération sur un serveur.
Create a new wallet crée les clés sur le serveur. Un Hot wallet y conserve la clé privée, si bien que BTCPay peut dépenser pour vous, pour les remboursements et les versements, mais toute personne ayant un accès administrateur au serveur le peut aussi. Le conseil de BTCPay lui-même est de "regularly withdraw funds to a different wallet" (retirer régulièrement les fonds vers un autre portefeuille). Un Watch-only wallet vous montre une seule fois les mots de récupération et efface la clé privée du serveur.
Quand BTCPay demande un type d’adresse, Segwit (Recommended) convient à la plupart des boutiques.
Create a store to begin accepting payments.
The recommended price source gets chosen based on the default currency.
La limite d’écart (gap limit). Votre application de portefeuille surveille à l’avance un nombre fixe d’adresses inutilisées, généralement 20. Chaque facture utilise une nouvelle adresse, donc après 20 factures impayées d’affilée, votre portefeuille peut cesser de voir les nouveaux paiements, même si BTCPay les enregistre. Si votre portefeuille a un réglage de limite d’écart, augmentez-le. Les paiements ne sont pas perdus, seulement cachés jusqu’à ce que le portefeuille regarde plus loin.
FAQ de BTCPay : portefeuilles et limite d’écart ↗ · BTCPay Vault ↗
Lightning
Lightning est facultatif et désactivé par défaut. Sur Connect to a Lightning node, il y a deux choix.
- Use internal node fait tourner un nœud Lightning sur le serveur BTCPay lui-même. C’est un portefeuille chaud sur une machine accessible depuis internet. La documentation de BTCPay avertit : "Do not use more than you can afford to lose." (N’y mettez pas plus que ce que vous pouvez vous permettre de perdre.) Ses mots de récupération ne restaurent que la partie sur la chaîne, et les canaux ont besoin de leur propre sauvegarde.
- Use custom node se connecte à un nœud Lightning que vous faites tourner ailleurs. BTCPay prend en charge LND, Core Lightning, Phoenixd et Eclair. Les connexions LNDhub nécessitent désormais un plugin.
Vous pouvez aussi accepter des paiements Lightning sans avoir votre propre nœud, grâce à des plugins. Ils sont présentés plus bas.
Les façons d’être payé
- Factures. Payments, puis Invoices, puis Create Invoice, pour un montant ponctuel dans votre devise.
- Point de vente. Une caisse pour un magasin ou un stand, par exemple sous forme de liste de produits, de liste de produits avec panier, ou de clavier pour saisir un montant.
- Demandes de paiement. Une demande de paiement est une page que vous envoyez à un client. Si vous l’autorisez, elle peut être payée en plusieurs fois, et chaque paiement utilise le taux de change du moment.
- Crowdfund. Une page de collecte de fonds à la manière de Kickstarter, payée directement dans votre portefeuille.
- Pay Button. Un bouton pour un site web. BTCPay prévient qu’il "should only be used for tips and donations" (ne devrait servir qu’aux pourboires et aux dons), car l’acheteur peut modifier les détails de commande qu’il envoie.
- Abonnements. Des formules récurrentes facturées au mois, au trimestre, à l’année ou une seule fois à vie. Bitcoin n’a pas de prélèvement automatique : les clients paient donc soit une facture à chaque période après un rappel, soit alimentent un solde créditeur sur lequel les renouvellements sont prélevés.
- Adresse Lightning. Une fois Lightning activé, la boutique peut avoir des adresses de la forme name@yourserver, que n’importe qui peut payer depuis un portefeuille Lightning.
- Pull Payments. L’inverse d’une facture. Vous fixez un montant et envoyez un lien, et la personne le réclame vers l’adresse de son choix. BTCPay les utilise pour les remboursements, et ils conviennent aussi aux versements au personnel ou aux contributeurs.
- Paiement par NFC. La page de paiement peut accepter une carte Lightning sans contact qu’on approche, comme une Boltcard.
Attendez qu’une facture affiche Settled avant de remettre la marchandise. Un client qui paie depuis une plateforme d’échange envoie parfois un peu moins, car la plateforme déduit ses propres frais de retrait. BTCPay marque alors la facture comme partiellement payée.
Guide utilisateur de BTCPay ↗ · BTCPay : Shopify V2 ↗
Boutiques en ligne et plugins
Boutiques en ligne. BTCPay se connecte à la plupart des logiciels de boutique. WooCommerce utilise un plugin WordPress installé sur votre site web. Shopify utilise la version 2 de l’intégration de BTCPay, qui tourne sur votre serveur BTCPay et nécessite un compte Shopify Partner. La version d’origine n’est plus en service. La documentation de BTCPay couvre aussi Magento, PrestaShop, Odoo, Wix, Ghost, Zapier et d’autres, et il existe une API pour vos propres systèmes.
Les plugins ajoutent des fonctions au serveur lui-même. Le Plugin Directory, dans le menu Plugins en haut à droite, en listait 57 pour la version 2.4.7. Quelques plugins utiles :
- Lightning sans votre propre nœud. Strike et Blink reçoivent sur un compte chez ces entreprises, qui détiennent l’argent pour vous. Breez et Flint font tourner un portefeuille Lightning léger à l’intérieur de BTCPay, mais gardent ses mots de récupération sur le serveur, où l’opérateur du serveur peut y accéder. Flint conserve en plus le solde sur Spark, un réseau distinct dont la propre documentation indique que l’argent n’est pas sous votre seule garde. Arkade et Bark utilisent Ark, une façon plus récente d’effectuer des paiements hors de la blockchain, et sont des logiciels encore jeunes.
- Votre propre nœud. Le plugin LSPS-1 achète un canal entrant auprès d’un fournisseur de services Lightning, pour qu’un nouveau nœud puisse recevoir tout de suite.
- Nostr. Le plugin Nostr donne à la boutique une adresse Nostr, accepte les zaps et peut recevoir sur un portefeuille connecté avec Nostr Wallet Connect, comme Alby Hub.
- Répartir et encaisser. Prism répartit chaque paiement entre plusieurs destinations, par exemple des associés ou un portefeuille d’épargne. Bringin transfère une part de ce que vous recevez vers un compte en euros chez Bringin.
- Laisser les clients payer avec d’autres cryptomonnaies. SideShift, FixedFloat et Trocador ajoutent un service d’échange au paiement. Le client paie avec une autre cryptomonnaie et vous recevez des bitcoins. Chaque service d’échange est un tiers avec ses propres conditions.
- Vendre des billets et en personne. TicketTailor et Satoshi Tickets vendent des billets d’événements. Boltcards Extension programme des cartes sans contact qui contiennent un solde Lightning. BTC Map ajoute votre commerce à une carte des lieux qui acceptent le bitcoin.
- Autres monnaies. Il existe des plugins pour Monero, Zcash et USDt. Le plugin Monero prévient qu’il utilise un seul portefeuille pour toutes les boutiques du serveur : ne l’utilisez donc que sur un serveur que vous ne partagez pas.
- Ecash. BTCNutServer accepte l’ecash Cashu. Sa propre description indique qu’il s’agit d’une bêta précoce qui n’a pas été auditée.
Seul l’administrateur du serveur peut installer des plugins : sur le serveur de quelqu’un d’autre, vous disposez donc de ceux qu’il a installés. Les plugins tournent à l’intérieur de BTCPay avec un accès à ses données. L’avertissement de BTCPay indique qu’ils "have not undergone review by the BTCPay Server team" (n’ont pas été examinés par l’équipe de BTCPay Server), et sa documentation conseille de n’installer que depuis des sources de confiance. Vérifiez qui maintient un plugin, tenez-le à jour, et sauvegardez d’abord le serveur.
Plugins are developed by third parties. They need to be updated and maintained regularly in addition to BTCPay Server. Use plugins at your own risk.
Documentation de BTCPay : plugins ↗ · Répertoire de plugins de BTCPay ↗ · Documentation de BTCPay : WooCommerce ↗
Remboursements et comptabilité
Sur une facture, Issue Refund vous permet de rembourser au taux du moment où le client a payé, au taux du jour, dans votre propre devise ou d’un montant personnalisé. BTCPay vous donne ensuite un lien à envoyer au client. Il saisit sa propre adresse, et vous approuvez et envoyez le versement dans Payments, puis Payouts.
Pour votre comptabilité, Payments, puis Reporting, exporte les factures, paiements, ventes, remboursements et plus encore sous forme de fichier tableur. Le portefeuille peut aussi exporter ses étiquettes de transactions au format standard BIP 329.
Sécurité et confidentialité
- Activez la connexion à deux facteurs. Dans Two-Factor Authentication, sur votre compte, vous pouvez ajouter une application d’authentification ou une clé de sécurité FIDO2. BTCPay prend aussi en charge les passkeys.
- Tenez le serveur à jour. Suivez les nouvelles versions de BTCPay, comme le montre la 2.4.7.
- Gardez les portefeuilles chauds petits, si vous en utilisez un.
- N’installez que les plugins dont vous avez besoin, et tenez-les à jour avec le serveur.
- Payjoin, qui rend les paiements plus difficiles à tracer, nécessite un portefeuille chaud dans BTCPay. Le guide Payjoin l’explique.
- Tor est facultatif. La FAQ de BTCPay ajoute que l’activer "doesn't make you anonymous at all" (ne vous rend pas du tout anonyme).
Chaque facture utilise une nouvelle adresse, ce qui protège la confidentialité de vos clients et la vôtre.
BTCPay : renforcer la sécurité ↗ · BTCPay : plugins ↗
Avant d’accepter de vrais paiements
- Vous avez créé vous-même le compte administrateur, juste après l’installation.
- La boutique utilise un portefeuille que vous détenez, connecté par sa clé publique, et ses mots de récupération sont sur papier.
- Vous avez payé une facture de test et l’avez vue arriver dans votre propre application de portefeuille.
- La connexion à deux facteurs est activée pour chaque compte du serveur.
- Le personnel sait qu’il faut attendre Settled.
- Vous savez comment effectuer un remboursement.
- Quelqu’un surveille les mises à jour de BTCPay.
Sources et lectures
Recherches du 18 novembre 2026. Les logiciels et les services évoluent : consultez la documentation actuelle avant d’agir.
- BTCPay Server ↗
- BTCPay Server: source code ↗
- BTCPay Server 2.4.7 release ↗
- BTCPay Server user guide (2.4.7) ↗
- BTCPay source: wallet setup options ↗
- BTCPay source: hot and watch-only wallets ↗
- BTCPay Docker deployment and hardware specs ↗
- BTCPay docs: deployment options ↗
- BTCPay docs: third-party hosting ↗
- BTCPay docs: wallet FAQ and gap limit ↗
- BTCPay docs: general FAQ ↗
- BTCPay docs: BTCPay Vault ↗
- BTCPay docs: Lightning ↗
- BTCPay docs: Shopify V2 ↗
- BTCPay docs: hardening ↗
- BTCPay docs: plugins ↗
- BTCPay Server Foundation ↗
- Umbrel: BTCPay Server app ↗
- BTCPay plugin directory ↗
- BTCPay docs: WooCommerce ↗
- BTCPay docs: subscriptions ↗
- BTCPay docs: pull payments ↗
- Flint plugin: trust model ↗
- Monero plugin ↗
- BTCNutServer (Cashu) plugin ↗
- Prism, Nostr, Bringin, SideShift and other plugins ↗
Umbrel : faites fonctionner un nœud et connectez-y vos portefeuilles → · Start9 : faites fonctionner un nœud et connectez-y vos portefeuilles → · Sparrow : créez un portefeuille que vous pouvez examiner → · Payjoin → · Choisissez le dispositif Lightning que vous pouvez entretenir → · Votre solde est un ensemble d’histoires → · Alby Hub : votre propre nœud Lightning, connecté à vos applications →
