Définissez le périmètre du portefeuille
Un portefeuille en lecture seule peut détecter les paiements sans détenir les clés privées de dépense. Une clé publique étendue révèle néanmoins une activité sensible du portefeuille et doit être protégée. L'intégration Lightning peut nécessiter un portefeuille en ligne et introduit un risque opérationnel supplémentaire.
Dimensionnez pour l’ensemble de la pile
Un backend Bitcoin, une base de données, un service web et un nœud Lightning facultatif ont des besoins de stockage et de mémoire différents. Consultez les instructions de déploiement actuellement prises en charge et les besoins de croissance avant de choisir une petite machine.
Sécurisez l'interface marchand
Utilisez un nom d'hôte dédié, HTTPS, une protection de connexion robuste et un accès administratif restreint. Maintenez le serveur à jour et vérifiez les signatures de webhook ou les mécanismes de vérification pris en charge dans l'application réceptrice. N'expédiez pas de marchandises sur la seule base d'une redirection de navigateur.
Sauvegarder et réconcilier
Protégez la configuration de la boutique, la base de données, les informations de récupération du portefeuille et les éléments propres à Lightning conformément à la documentation applicable. Testez la récupération et rapprochez les factures du système de paiement, notamment pour l'expiration, le sous-paiement et les remboursements.
Vérifiez la stratégie de déploiement et de chaîne
Utilisez les instructions de déploiement actuellement prises en charge, un nom d'hôte dédié et une route HTTPS vérifiée. Une chaîne élaguée peut réduire les besoins de stockage continus lorsqu'elle est prise en charge, mais les besoins de rescan et de récupération doivent être compris. Ne choisissez pas un disque uniquement d'après la taille actuelle de la chaîne ; laissez de la place pour l'ensemble de la pile et sa croissance.
- Vérifiez le rappel de paiement depuis un test externe
- Effectuez des paiements de test avant d'ouvrir une boutique en production
- Confirmez la politique de règlement des factures
Documentation officielle : Options de déploiement BTCPay
Conservez la clé de dépense là où vous le souhaitez
Une configuration en lecture seule peut détecter les paiements à partir d'une clé publique étendue sans donner la clé de dépense au serveur. La xpub est sensible car elle peut révéler l'activité du portefeuille. Un portefeuille chaud modifie ce risque en plaçant la capacité de dépense en ligne. Examinez séparément la garde du portefeuille et celle de Lightning et suivez la procédure de sauvegarde prise en charge.
Documentation officielle : Modèle de portefeuille BTCPay
Établir une liste de contrôle de déploiement adaptée à la pile choisie
Commencez par un domaine dédié, une méthode de déploiement prise en charge, le mode de chaîne prévu et un espace disque suffisant pour la synchronisation. Examinez le générateur Docker en amont et les composants sélectionnés avant l'installation ; conservez les choix de déploiement non secrets afin qu'une autre machine puisse être reconstruite de manière cohérente. Vérifiez la résolution du domaine, l'émission du certificat et la propriété du compte administratif avant de présenter un paiement à vos clients. Un exemple Docker Compose générique ne prouve pas que chaque composant facultatif BTCPay est configuré.
- Déterminez quel propriétaire d'instance contrôle les mises à jour, la surveillance, les sauvegardes et la réponse aux incidents.
- Séparez l'exposition du reverse-proxy de l'administration privée RPC Bitcoin, de la base de données et de Lightning.
- Documentez les limites de récupération/rescan d'un backend élagué avant de connecter un portefeuille avec des paiements historiques.
- Maintenez un environnement de test pris en charge ou un petit exercice de paiement contrôlé pour les intégrations avant d'exécuter des commandes de valeur.
Documentation officielle : Serveur BTCPay : choix de déploiement · Serveur BTCPay : déploiement Docker pris en charge
Enquêtez sur les paiements de portefeuille manquants sans importer de phrase de récupération
Une boutique peut utiliser les informations xpub/dérivation d’un portefeuille tandis que la clé de dépense reste sur un autre appareil. Testez la réception et le parcours de récupération avec le portefeuille choisi. Si BTCPay voit le paiement d’une facture mais qu’un portefeuille externe ne l’affiche pas, examinez son schéma de dérivation et le comportement de sa limite d’écart d’adresses avant de supposer que les fonds ont disparu. De longues séries d’adresses générées non payées peuvent affecter la découverte d’un portefeuille. Utilisez les diagnostics de portefeuille pris en charge plutôt que de copier les mots de récupération sur le serveur.
Documentation officielle : BTCPay Server : dépannage du portefeuille et de la dérivation
Rapprochez les factures avant l'exécution
Enregistrez les identifiants de facture et rendez l'opération d'exécution idempotente. Le retour d'un navigateur vers la boutique est un événement de navigation, non une preuve de règlement. Vérifiez l'état du paiement via votre intégration serveur authentifiée, gérez explicitement les factures expirées, tardives ou sous-payées, et conservez un parcours de révision pour les issues non résolues. Si un rappel se répète, renvoyer un accusé de réception réussi ne doit ni expédier ni créditer la commande deux fois.
- Testez un paiement arrivant près de l'expiration et vérifiez que la commande reste associée à la bonne facture.
- Conservez la base de données, la configuration de la boutique et les éléments de récupération du portefeuille dans une sauvegarde indépendante et testée.
- Lightning ajoute une responsabilité distincte de liquidité et de sauvegarde des canaux ; restaurer l'intégralité du VPS de la veille n'est pas une procédure de récupération universelle sûre.
- Héberger une instance BTCPay n'ajoute ni Lightning ni XMR au paiement des clients de KoalaVPS ; les moyens de paiement de ce site d'hébergement restent ses sept parcours publiés.
Documentation officielle : Guide développeur Bitcoin : vérification des paiements · LND : reprise après sinistre · Core Lightning : sauvegardes du portefeuille et des canaux