BITCOIN LIGHTNING

Acepta pagos Lightning.

Conecta una wallet receptora, actívala en tu tienda y deja que los clientes paguen con un QR Lightning.

Una conexión de wallet, no un nodo público.

Un endpoint público de Bitcoin puede leer la blockchain. No puede recibir pagos Lightning por ti. Lightning necesita una wallet que cree facturas e informe de su liquidación.

Tu configuración	Conectar con	¿Quién lo mantiene?
Tu propio nodo	LND por HTTPS o una wallet NWC compatible	Tú gestionas claves, canales, liquidez y copias de seguridad.
Wallet de autocustodia gestionada	NWC, por ejemplo Alby Hub con alojamiento	Un servicio ayuda a operarla. Comprueba que mantienes el control de las claves y el acceso a la recuperación.
Cuenta con custodia	Conexión NWC de un proveedor compatible	El proveedor guarda tus fondos. Comisiones, límites de cuenta y requisitos de verificación dependen del proveedor.

NWC es un protocolo de conexión, no una garantía de custodia. Elige el modelo de wallet adecuado para tu negocio. Wholly Crypto no guarda fondos Lightning ni instala un nodo.

Conecta tu nodo LND.

Abre Ajustes → Conexiones de redes → Conectar Lightning. Elige LND · HTTPS.
Introduce el endpoint REST HTTPS accesible desde fuera y un macaroon restringido en formato hexadecimal. Permite lectura/escritura de facturas y info:read. Añade offchain:read si quieres mostrar los saldos de canales. Nunca uses admin.macaroon ni concedas permisos de gasto.
Si LND usa su propio certificado TLS, pega su certificado público PEM. No pegues una clave privada TLS. Permite el acceso desde tu VPS de comercio en el firewall del nodo.
Selecciona los proyectos autorizados para usar la conexión. Comprueba y guarda, y después actívala para nuevas facturas.

El nodo debe estar sincronizado con la red principal de Bitcoin. La verificación TLS permanece activada. Esta conexión solo acepta direcciones HTTPS públicas; las privadas, de bucle local y reservadas están bloqueadas. Mantén el nodo separado del servidor de pagos.

Permisos de macaroon LND ↗

Conecta mediante Nostr Wallet Connect.

En Alby Hub u otra wallet compatible, crea una conexión dedicada a recibir.
Permite make_invoice, lookup_invoice y get_info. get_balance es opcional. No permitas métodos de pago ni retirada.
Elige Nostr Wallet Connect en Wholly Crypto y pega la cadena de conexión completa nostr+walletconnect://… . Trátala como una contraseña.
Usa un relay WSS público en la cadena de conexión. Elige el modelo de custodia y el acceso de proyectos, y después comprueba y guarda.

Wholly Crypto verifica las respuestas firmadas y admite cifrado NIP-44 v2 con compatibilidad con el antiguo NIP-04. La wallet debe permitir consultar facturas entrantes con prueba de liquidación. No todas las cuentas NWC admiten todos los métodos de recepción.

Guía de Alby Hub ↗ · Especificación NWC ↗

Actívalo para tu tienda.

Abre Proyecto → Tiendas → Métodos de pago → Bitcoin Lightning. Elige la conexión y actívala. Bitcoin en la blockchain es una opción separada; puedes ofrecer una o ambas.

Crea una factura pequeña manualmente o con la API habitual. Al pagar, elige Bitcoin y después Bitcoin Lightning. Escanea el QR o abre la solicitud en una wallet Lightning. No necesitas una ruta API nueva para crear una factura.

Pagado significa liquidado.

Cada solicitud recibe su propia factura BOLT11 y hash de pago. Los precios usan la moneda fiat y el margen de la tienda, redondeados hacia arriba a satoshis enteros. Wholly Crypto registra los recibos con precisión de millisatoshi.

Un pago retenido o detectado no basta. La wallet debe informar de la liquidación con una prueba de pago válida. No se necesitan confirmaciones de bloques. El historial de facturas, las comisiones, IPN y webhooks siguen el flujo normal de facturas.

LND usa una suscripción de liquidación por conexión y consultas de recuperación. NWC usa consultas de facturas. Las consultas pendientes suelen ejecutarse cada 10 segundos; las interrupciones, colas y límites del proveedor pueden retrasar las actualizaciones. Las solicitudes sin liquidar siguen bajo seguimiento durante 24 horas tras vencer la factura del comercio.

Desactivar o sustituir credenciales no mueve una solicitud existente a otra wallet. Mantén operativas las credenciales receptoras antiguas hasta que terminen las solicitudes pendientes. No deben pagarse solicitudes vencidas o canceladas.

Esta integración recibe pagos. Usa la wallet conectada para envíos, reembolsos, gestión de canales o transferencias a exchanges. Los saldos Lightning son saldos de wallet compartidos, no wallets separadas por proyecto. Las comisiones de proveedor, enrutamiento y canales son aparte de la comisión de procesamiento de Wholly Crypto.

Ten listas la capacidad y las copias de seguridad.

Tu nodo necesita capacidad entrante en los canales para recibir. Una wallet conectada sin ruta utilizable o capacidad de recepción puede no recibir un pago. Un servicio de liquidez puede ayudar, pero sus costes y condiciones varían.

La copia de texto de las wallets del proyecto no incluye Lightning. Sigue el procedimiento de recuperación de tu nodo o wallet, incluidas las copias de canales que requiera. Una frase semilla por sí sola quizá no recupere los fondos de canales de forma segura. Guarda una copia de la base de datos y la clave de cifrado de Wholly Crypto para conservar el seguimiento de facturas y las credenciales de conexión cifradas.

Guía de recuperación de LND ↗

Comprueba primero la conexión.

Acceso rechazado: comprueba los permisos de recepción y si la credencial sigue siendo válida.
Fallo de conexión: comprueba HTTPS/WSS, TLS, DNS, acceso del firewall y si la wallet está conectada.
Solicitud no disponible: comprueba acceso del proyecto, activación de la tienda, tipos de cambio actuales y conexión de la wallet a la red principal.
No hay ruta para el pago: comprueba la liquidez entrante en tu wallet Lightning. Una conexión API en buen estado no demuestra que exista una ruta.

Prueba un pago pequeño y su flujo de notificaciones antes de ofrecer Lightning a clientes. Nunca envíes claves de wallet, macaroons ni secretos NWC al soporte.