capyQR
← Todos os artigos

Códigos QR de Bitcoin: como o formato de URI bitcoin: funciona de verdade

Como criar um código QR de URI bitcoin: (BIP21) com valor fixo, rótulo e mensagem — um formato de pagamento que realmente funciona em quase todas as carteiras.

·5 min de leitura

Ao contrário de algumas plataformas de pagamento, o Bitcoin realmente tem um formato de QR padronizado e bem suportado — a URI bitcoin: (BIP21) funciona em quase todo app de carteira. Veja exatamente como criar uma, com ou sem valor fixo.

O formato de URI bitcoin:

Um código QR de Bitcoin codifica uma URI no formato bitcoin:[seu endereço], opcionalmente estendida com parâmetros:

Um exemplo completo: bitcoin:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh?amount=0.001&label=Cafeteria. A maioria das carteiras lê esse padrão diretamente, sem nenhuma configuração extra necessária do lado de quem envia.

Como criar um

  1. Pegue seu endereço de recebimento de Bitcoin na sua carteira.
  2. Monte a URI — apenas bitcoin:endereço para um valor aberto, ou adicione ?amount= para um valor fixo.
  3. Codifique com o gerador de código QR de texto do Capy QR — a URI bitcoin: funciona igual a qualquer outro conteúdo de texto.

Valor fixo vs. valor aberto

Crie o seu no editor → capyqr.com

Uma nota sobre privacidade

Um único endereço estático reusado indefinidamente (como em uma placa impressa) é simples, mas prende todos os pagamentos a um único endereço visível na blockchain. Para mais privacidade, algumas pessoas geram um endereço novo por transação e criam um código QR novo a cada vez — vale a pena avaliar isso frente à conveniência de um código impresso permanente, dependendo do seu caso de uso.

Um código pronto para um endereço de carteira

Aqui está um Capy QR com estilo para um recibo, fatura ou display de balcão:

Um Capy QR com o preset Mono — alto contraste, pronto para codificar uma URI bitcoin: que qualquer carteira consiga escanear.

Perguntas frequentes

Como faço um código QR de Bitcoin?
Codifique uma URI bitcoin: — bitcoin:[seu endereço] ou bitcoin:[endereço]?amount=0.001 para um valor fixo — em um código QR. Quase todo app de carteira Bitcoin consegue escanear esse formato diretamente e preencher o pagamento automaticamente.
O que é o formato de URI bitcoin:?
É um formato padronizado (BIP21) que a maioria das carteiras suporta: bitcoin:ENDEREÇO opcionalmente seguido de ?amount=X&label=Y&message=Z. Isso permite que um código QR preencha automaticamente o endereço do destinatário, o valor e até uma observação em um único escaneamento.
Posso definir um valor fixo em um código QR de Bitcoin?
Sim — adicione ?amount=0.001 (ou o valor que quiser, em BTC) à URI bitcoin: antes de codificá-la. A carteira do destinatário vai preencher esse valor automaticamente, embora quem envia geralmente ainda consiga editá-lo antes de confirmar.
É seguro exibir um código QR de Bitcoin publicamente, como em uma barraca de feira?
Um código QR de endereço de recebimento só permite que as pessoas te enviem Bitcoin — ele não pode ser usado para sacar fundos. Por privacidade, algumas pessoas preferem gerar um endereço novo a cada transação em vez de reusar um código estático indefinidamente, embora um único endereço seja mais simples para uma exibição fixa.
Todas as carteiras suportam o esquema de URI bitcoin:?
A grande maioria das carteiras Bitcoin suporta o escaneamento de URIs bitcoin: — é um padrão bem estabelecido e amplamente adotado (BIP21), não algo específico de uma carteira ou provedor.

Resumindo: a URI bitcoin: do Bitcoin é um dos poucos formatos de pagamento que realmente funciona como um padrão de QR universal — sem ressalvas específicas de plataforma. Pronto para criar um? Abra o gerador de código QR de texto ou veja mais guias de QR.