LIGHTNING

Cobre em Lightning, liquide em Pix

Quem paga está em qualquer lugar e usa Lightning. Quem recebe está no Brasil e recebe reais por Pix. A ponte entre os dois é uma chamada de API.

LightningLightning
BitcoinBitcoin
PixPix
SparkSpark

O que é liquidar Lightning em Pix

É receber um pagamento na Lightning Network e entregar o valor em reais, por Pix, para quem recebe no Brasil. A invoice é emitida do seu lado por uma chamada de API. O pagador escaneia ou cola, paga em bitcoin, e o payout Pix é disparado automaticamente quando a invoice é liquidada.

Para quem paga, é um pagamento Lightning comum. Para quem recebe, é um Pix comum em reais. Nenhum dos dois lados precisa lidar com o outro trilho.

  • Quem paga usa Lightning, de qualquer lugar.
  • Quem recebe cai em reais por Pix, no Brasil.
  • O payout dispara sozinho quando a invoice é paga.
  • Você não precisa rodar nó Lightning nem manter canal.

Da invoice ao Pix liquidado

Quatro etapas. A primeira é sua; as três seguintes acontecem sozinhas.

  1. 1Emitir a invoice. Um POST em /api/lightning/invoice devolve uma BOLT11 com valor e validade.
  2. 2Entregar ao pagador. Você mostra o QR code ou o texto lnbc... onde faz sentido no seu produto.
  3. 3Pagamento. O pagador liquida a invoice na Lightning Network, de qualquer lugar.
  4. 4Liquidação em reais. O payout Pix é disparado automaticamente e liquida em segundos. O webhook assinado avisa cada transição.

Quem tem esse problema

O caso mais direto é receber de fora do Brasil sem passar por transferência internacional. Prestador de serviço com cliente no exterior, plataforma que paga colaborador em outro país, e-commerce vendendo para fora — todos precisam que o dinheiro chegue em reais, na conta brasileira, sem depender de horário bancário.

Lightning resolve a perna internacional e o Pix resolve a perna local. O que faltava era a costura entre as duas, e é isso que a API entrega.

  • Prestador de serviço com cliente fora do Brasil.
  • Plataforma que recebe de pagador internacional e liquida local.
  • Operação que não pode esperar horário bancário.

Uma chamada emite, o webhook fecha

O endpoint de invoice é documentado com as telas, as chamadas e os modos de falha. A confirmação chega por webhook assinado com HMAC, não por polling.

  • POST /api/lightning/invoice — emite a BOLT11.
  • Webhook assinado com HMAC em cada mudança de estado.
  • Extrato com saldo por ativo e operações paginadas.
  • Guia completo em docs.hodle.com.br/docs/flow-lightning-pix.

Bitcoin, Lightning e o trilho brasileiro

Bitcoin circula on-chain e por Lightning. A Spark também transporta ativos sobre o Bitcoin. A saída em reais é por Pix, 24 horas por dia, todos os dias.

BitcoinBitcoin
LightningLightning
SparkSpark
PixPix

Perguntas frequentes

Tire suas dúvidas sobre receber em Lightning e liquidar em Pix.

Como receber um pagamento em Lightning e sacar em Pix?

Você emite uma invoice BOLT11 com um POST em /api/lightning/invoice e entrega ao pagador. Quando ele paga, o payout Pix é disparado automaticamente e liquida em reais em segundos, na conta de quem recebe no Brasil.

Quem paga precisa saber de Pix?

Não. Do lado de quem paga é um pagamento Lightning comum: escanear ou colar a invoice e pagar em bitcoin. O Pix acontece só na perna brasileira, depois.

Quanto tempo leva?

A liquidação em reais acontece em segundos depois que a invoice é paga, e funciona 24 horas por dia, sem depender de horário bancário.

Preciso rodar um nó Lightning?

Não. A emissão da invoice e a liquidação são operações da API. Você não mantém nó, não abre canal e não administra liquidez de rede.

O que acontece se a invoice não for paga?

A invoice tem prazo de validade e expira sem que nada seja movimentado. Nenhum payout é disparado, e o webhook informa o estado. Você pode emitir outra.

Pronto para começar?

Comece pela documentação ou fale com o time da Hodle.