Skip to main content

Código QR | Bitcoin Glossary | Mapping Bitcoin

Código QR

Geral

Also known as: quick response code

Código de barras 2D para codificar endereços Bitcoin e faturas Lightning, facilitando pagamentos pelo escaneamento com câmera em dispositivos móveis e PDV.

Visão geral

Os códigos QR tornaram-se uma parte essencial da experiência do usuário Bitcoin. Endereços Bitcoin, faturas Lightning e URIs de pagamento são longas strings de caracteres impraticáveis para digitar manualmente. Os códigos QR resolvem isso codificando informações de pagamento em um código de barras bidimensional escaneável, permitindo transferências rápidas e sem erros entre dispositivos. Quase todas as carteiras Bitcoin suportam tanto a geração quanto o escaneamento de códigos QR.

Códigos QR em pagamentos Bitcoin

Fluxo de pagamento com Código QR:

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Destinatário│     │  Código QR   │     │  Remetente   │
│  gera        │────>│  exibido     │────>│  escaneia QR │
│  fatura      │     │  na tela     │     │  com telefone│
└──────────────┘     └──────────────┘     └──────┬───────┘
                                                  │
                                           ┌──────▼───────┐
                                           │  Carteira    │
                                           │  analisa e   │
                                           │  confirma    │
                                           │  pagamento   │
                                           └──────────────┘

Conteúdos QR comuns:
• bitcoin:bc1q...?amount=0.001    (URI BIP21)
• lnbc10u1p...                    (Fatura Lightning)
• lnurl1dp68...                   (Endpoint LNURL)

URIs de pagamento BIP21

O padrão BIP21 define um esquema URI que os códigos QR tipicamente codificam para pagamentos on-chain. Um URI BIP21 pode incluir o endereço, um valor solicitado, um rótulo e uma mensagem. As implementações modernas também podem incluir uma fatura Lightning como parâmetro de fallback, permitindo que a carteira do remetente escolha o método de pagamento mais adequado.

Capacidade do código QR

Os códigos QR vêm em diferentes tamanhos (versões) com capacidade de dados variável. Um endereço Bitcoin padrão cabe facilmente em um código QR pequeno, mas as faturas Lightning podem ser bastante longas (centenas de caracteres), exigindo códigos QR maiores. O LNURL aborda isso codificando uma URL curta que resolve para a fatura completa, mantendo os códigos QR compactos e facilmente escaneáveis.

Considerações de segurança

Embora os códigos QR em si sejam simplesmente um formato de codificação de dados e não carreguem nenhum risco de segurança inerente, os usuários devem ter cuidado com:

  • Ataques de substituição de código QR — Software malicioso poderia substituir um código QR exibido pelo endereço do invasor. Sempre verifique os primeiros e últimos caracteres de um endereço antes de enviar.
  • Códigos QR de phishing — Códigos QR afixados em lugares públicos poderiam apontar para sites maliciosos ou codificar endereços controlados pelo invasor.

Em pontos de venda

Os códigos QR são essenciais para pagamentos Bitcoin em pontos de venda. O sistema POS do comerciante gera uma fatura, a exibe como um código QR e o cliente a escaneia com sua carteira móvel. No Lightning, todo o processo desde o escaneamento até o pagamento confirmado tipicamente leva apenas alguns segundos.