BITCOIN LIGHTNING

Receba pagamentos Lightning.

Conecte uma carteira de recebimento, ative na sua loja e permita que clientes paguem com um QR Lightning.

Uma conexão de carteira, não um nó público.

Um endpoint público de Bitcoin pode ler a blockchain. Ele não pode receber pagamentos Lightning por você. Lightning precisa de uma carteira que crie faturas e informe quando forem liquidadas.

Sua configuração	Conectar com	Quem cuida disso?
Seu próprio nó	LND por HTTPS ou uma carteira NWC compatível	Você gerencia chaves, canais, liquidez e backups.
Carteira de autocustódia gerenciada	NWC, por exemplo Alby Hub com hospedagem	Um serviço ajuda a operá-la. Confira se você mantém o controle das chaves e o acesso à recuperação.
Conta com custódia	Conexão NWC de um provedor compatível	O provedor guarda seus fundos. Taxas, limites de conta e requisitos de verificação dependem do provedor.

NWC é um protocolo de conexão, não uma garantia de custódia. Escolha o modelo de carteira adequado ao seu negócio. Wholly Crypto não guarda fundos Lightning nem instala um nó.

Conecte seu nó LND.

Abra Configurações → Conexões de redes → Conectar Lightning. Escolha LND · HTTPS.
Insira o endpoint REST HTTPS acessível externamente e um macaroon restrito em formato hexadecimal. Permita leitura/gravação de faturas e info:read. Adicione offchain:read se quiser mostrar os saldos dos canais. Nunca use admin.macaroon nem conceda permissões de gasto.
Se LND usa seu próprio certificado TLS, cole o certificado público PEM dele. Não cole uma chave privada TLS. Permita o acesso do seu VPS de lojista no firewall do nó.
Selecione os projetos autorizados a usar a conexão. Verifique e salve, depois ative para novas faturas.

O nó precisa estar sincronizado com a rede principal do Bitcoin. A verificação TLS permanece ativada. Esta conexão só aceita endereços HTTPS públicos; os privados, de loopback e reservados são bloqueados. Mantenha o nó separado do servidor de pagamentos.

Permissões de macaroon LND ↗

Conecte via Nostr Wallet Connect.

No Alby Hub ou em outra carteira compatível, crie uma conexão dedicada ao recebimento.
Permita make_invoice, lookup_invoice e get_info. get_balance é opcional. Não permita métodos de pagamento nem saque.
Escolha Nostr Wallet Connect no Wholly Crypto e cole a string de conexão completa nostr+walletconnect://… . Trate-a como uma senha.
Use um relay WSS público na string de conexão. Escolha o modelo de custódia e o acesso dos projetos, depois verifique e salve.

Wholly Crypto verifica as respostas assinadas e aceita criptografia NIP-44 v2 com compatibilidade com o antigo NIP-04. A carteira precisa permitir a consulta de faturas recebidas com prova de liquidação. Nem toda conta NWC aceita todos os métodos de recebimento.

Guia do Alby Hub ↗ · Especificação NWC ↗

Ative para sua loja.

Abra Projeto → Lojas → Formas de pagamento → Bitcoin Lightning. Escolha a conexão e ative. Bitcoin na blockchain é uma opção separada; você pode oferecer uma ou ambas.

Crie uma fatura pequena manualmente ou pela API normal. No checkout, escolha Bitcoin e depois Bitcoin Lightning. Escaneie o QR ou abra a solicitação em uma carteira Lightning. Não precisa de uma nova rota de API para criar uma fatura.

Pago significa liquidado.

Cada solicitação recebe sua própria fatura BOLT11 e hash de pagamento. Os preços usam a moeda fiduciária e a margem da loja, arredondados para cima a satoshis inteiros. Wholly Crypto registra recebimentos com precisão de millisatoshi.

Um pagamento retido ou detectado não basta. A carteira precisa informar a liquidação com uma prova de pagamento válida. Não são necessárias confirmações de blocos. Histórico de faturas, taxas, IPN e webhooks seguem o fluxo normal de faturas.

LND usa uma assinatura de liquidação por conexão e consultas de recuperação. NWC usa consultas de faturas. Consultas pendentes normalmente ocorrem a cada 10 segundos; interrupções, filas e limites do provedor podem atrasar as atualizações. Solicitações não liquidadas continuam sendo monitoradas por 24 horas após o prazo da fatura do lojista.

Desativar ou substituir credenciais não move uma solicitação existente para outra carteira. Mantenha as credenciais de recebimento antigas funcionando até terminar as solicitações pendentes. Solicitações vencidas ou canceladas não devem ser pagas.

Esta integração recebe pagamentos. Use a carteira conectada para envios, reembolsos, gerenciamento de canais ou transferências para exchanges. Saldos Lightning são saldos de carteira compartilhados, não carteiras separadas por projeto. Taxas do provedor, roteamento e canais são separadas da taxa de processamento do Wholly Crypto.

Mantenha capacidade e backups prontos.

Seu nó precisa de capacidade de entrada nos canais para receber. Uma carteira conectada sem rota utilizável ou capacidade de recebimento ainda pode falhar ao receber um pagamento. Um serviço de liquidez pode ajudar, mas custos e condições variam.

O backup de texto das carteiras do projeto não inclui Lightning. Siga o procedimento de recuperação do seu nó ou carteira, incluindo os backups de canais exigidos. Uma frase-semente sozinha pode não recuperar os fundos dos canais com segurança. Faça backup do banco de dados e da chave de criptografia do Wholly Crypto para preservar o monitoramento de faturas e as credenciais de conexão criptografadas.

Guia de recuperação do LND ↗

Verifique primeiro a conexão.

Acesso rejeitado: confira as permissões de recebimento e se a credencial ainda é válida.
Falha na conexão: confira HTTPS/WSS, TLS, DNS, acesso do firewall e se a carteira está online.
Solicitação indisponível: confira acesso do projeto, ativação da loja, cotações atuais e conexão da carteira à rede principal.
Não há rota para o pagamento: confira a liquidez de entrada na sua carteira Lightning. Uma conexão de API saudável não comprova que existe uma rota.

Teste um pagamento pequeno e seu fluxo de notificações antes de oferecer Lightning aos clientes. Nunca envie chaves de carteira, macaroons nem segredos NWC ao suporte.