BITCOIN LIGHTNING

Accepte les paiements Lightning.

Connecte un portefeuille de réception, active-le dans ton magasin et permets aux clients de payer avec un QR code Lightning.

Une connexion à un portefeuille, pas un nœud public.

Un endpoint Bitcoin public peut lire la blockchain. Il ne peut pas recevoir de paiements Lightning pour toi. Lightning nécessite un portefeuille qui crée les factures et signale leur règlement.

Ta configuration	Connecter avec	Qui s'en occupe ?
Ton propre nœud	LND via HTTPS ou un portefeuille NWC compatible	Tu gères les clés, les canaux, la liquidité et les sauvegardes.
Portefeuille en autogarde géré	NWC, par exemple Alby Hub avec hébergement	Un service t'aide à l'exploiter. Vérifie que tu conserves le contrôle des clés et l'accès à la récupération.
Compte avec garde des fonds	La connexion NWC d'un fournisseur compatible	Le fournisseur détient tes fonds. Les frais, limites du compte et exigences de vérification dépendent du fournisseur.

NWC est un protocole de connexion, pas une garantie de garde des fonds. Choisis le modèle de portefeuille adapté à ton activité. Wholly Crypto ne détient pas de fonds Lightning et n'installe pas de nœud.

Connecte ton nœud LND.

Ouvre Réglages → Connexions blockchain → Connecter Lightning. Choisis LND · HTTPS.
Saisis l'endpoint REST HTTPS accessible de l'extérieur et un macaroon à permissions limitées au format hexadécimal. Autorise la lecture/écriture des factures et info:read. Ajoute offchain:read si tu veux afficher les soldes des canaux. N'utilise jamais admin.macaroon et n'accorde pas de permissions de dépense.
Si LND utilise son propre certificat TLS, colle son certificat PEM public. Ne colle pas de clé privée TLS. Autorise l'accès depuis ton VPS commerçant dans le pare-feu du nœud.
Sélectionne les projets autorisés à utiliser la connexion. Vérifie et enregistre, puis active-la pour les nouvelles factures.

Le nœud doit être synchronisé avec le réseau principal Bitcoin. La vérification TLS reste active. Cette connexion accepte uniquement les adresses HTTPS publiques ; les adresses privées, de bouclage et réservées sont bloquées. Garde le nœud séparé de ton serveur de paiement.

Permissions des macaroons LND ↗

Connecte-toi via Nostr Wallet Connect.

Dans Alby Hub ou un autre portefeuille compatible, crée une connexion dédiée à la réception.
Autorise make_invoice, lookup_invoice et get_info. get_balance est facultatif. N'autorise pas de méthodes de paiement ou de retrait.
Choisis Nostr Wallet Connect dans Wholly Crypto et colle la chaîne complète de connexion nostr+walletconnect://… . Traite-la comme un mot de passe.
Utilise un relais WSS public dans la chaîne de connexion. Choisis ton modèle de garde et l'accès aux projets, puis vérifie et enregistre.

Wholly Crypto vérifie les réponses signées et prend en charge le chiffrement NIP-44 v2 avec compatibilité NIP-04 historique. Le portefeuille doit permettre la recherche de factures entrantes avec preuve de règlement. Tous les comptes NWC ne prennent pas en charge toutes les méthodes de réception.

Guide Alby Hub ↗ · Spécification NWC ↗

Active-le pour ton magasin.

Ouvre Projet → Magasins → Moyens de paiement → Bitcoin Lightning. Choisis la connexion et active-la. Bitcoin on-chain est un choix distinct ; tu peux proposer l'un, l'autre ou les deux.

Crée une petite facture manuellement ou via l'API habituelle. Sur la page de paiement, choisis Bitcoin puis Bitcoin Lightning. Scanne le QR code ou ouvre la demande dans un portefeuille Lightning. Aucune nouvelle route API n'est nécessaire pour créer une facture.

Payé signifie réglé.

Chaque demande reçoit sa propre facture BOLT11 et son hash de paiement. Les prix utilisent la devise fiat et le spread du magasin, arrondis au satoshi entier supérieur. Wholly Crypto enregistre les réceptions avec une précision au millisatoshi.

Un paiement retenu ou détecté ne suffit pas. Le portefeuille doit signaler le règlement avec une preuve de paiement valide. Aucune confirmation de bloc n'est nécessaire. L'historique des factures, les frais de traitement, l'IPN et les webhooks suivent le parcours habituel des factures.

LND utilise un abonnement aux règlements par connexion, plus des recherches de récupération. NWC utilise des recherches de factures. Les demandes en attente sont normalement vérifiées environ toutes les 10 secondes ; les pannes, files et limites des fournisseurs peuvent retarder les mises à jour. Les demandes non réglées restent surveillées pendant 24 heures après l'échéance de la facture commerçant.

Désactiver ou remplacer les identifiants ne déplace pas une demande existante vers un autre portefeuille. Garde les anciens identifiants de réception fonctionnels jusqu'à la fin des demandes en attente. Les demandes expirées ou annulées ne doivent pas être payées.

Cette intégration reçoit des paiements. Utilise le portefeuille connecté pour les envois, remboursements, la gestion des canaux ou les transferts vers une plateforme. Les soldes Lightning sont des soldes partagés du portefeuille, pas des portefeuilles distincts par projet. Les frais du fournisseur, de routage et de canaux sont distincts des frais de traitement Wholly Crypto.

Prépare la capacité et les sauvegardes.

Ton nœud a besoin de capacité entrante dans les canaux pour recevoir. Un portefeuille connecté sans route utilisable ou capacité de réception peut tout de même échouer à recevoir un paiement. Un service de liquidité peut aider, mais les coûts et conditions varient.

La sauvegarde texte des portefeuilles du projet ne sauvegarde pas Lightning. Suis la procédure de récupération de ton nœud ou portefeuille, y compris les sauvegardes de canaux requises. Une phrase de récupération seule peut ne pas restaurer les fonds des canaux en sécurité. Sauvegarde la base Wholly Crypto et la clé de chiffrement pour préserver le suivi des factures et les identifiants de connexion chiffrés.

Guide de récupération LND ↗

Vérifie d'abord la connexion.

Accès refusé : vérifie les permissions de réception et si l'identifiant est toujours valide.
Échec de connexion : vérifie HTTPS/WSS, TLS, DNS, l'accès du pare-feu et si le portefeuille est en ligne.
Demande indisponible : vérifie l'accès au projet, l'activation du magasin, les taux actuels et le statut réseau principal du portefeuille.
Routage du paiement impossible : vérifie la liquidité entrante de ton portefeuille Lightning. Une connexion API opérationnelle ne prouve pas qu'une route existe.

Teste un petit paiement et son parcours de notification avant de proposer Lightning aux clients. N'envoie jamais de clés de portefeuille, macaroons ni secrets NWC au support.