qr-implementation
Um QR code de casamento costuma falhar por um de cinco motivos: tamanho, contraste, danos, tela no modo escuro ou print de baixa qualidade. Veja como corrigir cada um.
Quando um QR code de casamento não escaneia, quase sempre é por um de cinco motivos: tamanho, contraste, danos físicos, exibição no modo escuro ou um print degradado. O código pode ser pequeno demais para a distância de leitura, ter sido impresso com pouco contraste ou estar danificado. Pode ser também que o aplicativo de câmera do convidado não leia QR codes nativamente, ou que o arquivo tenha sido reenviado como print tantas vezes que perdeu a nitidez. Veja abaixo a solução para cada caso.
| Symptom | Causa provável | Fix |
|---|---|---|
| Nada acontece de perto | Código menor que cerca de 2x2 cm ou abaixo da proporção de distância de 10:1 | Reimprima em 3 cm (1,2 pol.) para cartões de mesa ou 12 cm (5 pol.) para placas lidas do outro lado da sala |
| O convidado precisa encostar o celular no cartão | Margem de respiro muito estreita ou código muito próximo de textos ou imagens | Mova o código para uma área lisa com espaço livre nos quatro lados |
| Leitura lenta ou sem leitura sob a luz de velas | Papel com brilho ou semibrilho refletindo luz | Reimprima em papel fosco |
| Funciona bem em telas brilhantes, mas falha no papel | Cores do código e do fundo muito parecidas, ou código claro sobre fundo escuro | Reimprima com módulos escuros sobre um fundo claro e liso |
| Cartão rasgado, enrolado ou amassado | O dano físico quebra o padrão de leitura | Reimprima ou troque o cartão |
| Funciona para alguns convidados e não para outros, no mesmo cartão | O aplicativo de câmera do Android do convidado não lê QR codes nativamente | O convidado pode usar o Google Lens ou digitar o link impresso |
| Falha ao ser exibido em celular ou site, mas funciona impresso | Modo escuro forçado invertendo as cores do código exibido | Use o cartão impresso ou desative o modo escuro nessa página |
| Funcionou bem uma vez, mas falha ao ser compartilhado | Compressão de prints e reenvios degradou o arquivo | Envie o arquivo original, não um print de outro print compartilhado |
Geralmente há algo errado com o tamanho, o contraste, o estado de conservação ou o próprio arquivo. A maioria dos cartões impressos falha porque o código é pequeno demais para a distância de leitura ou não tem o contraste escuro sobre fundo claro de que a câmera precisa. Um código exibido em uma tela pode falhar por outro motivo: o modo escuro forçado inverte suas cores. Além disso, um código compartilhado como print muitas vezes perde detalhes a ponto de não ser mais reconhecido.
O limite mínimo absoluto é de cerca de 2x2 cm, com aproximadamente quatro módulos de espaço livre (a margem de respiro) em cada lado. Acima disso, o tamanho segue uma proporção de 10:1: cerca de 1 cm de código para cada 10 cm de distância de leitura. Um cartão de mesa lido à distância de um braço precisa de pelo menos 3 cm (1,2 pol.); uma placa de boas-vindas, lida a cerca de um metro de distância na chegada dos convidados, precisa de aproximadamente 12 cm (5 pol.).
Os leitores esperam módulos escuros sobre um fundo claro. Um código impresso de forma invertida (claro sobre escuro) ou posicionado sobre uma foto cheia de detalhes ou efeito aquarela não oferece contraste suficiente para a câmera focar. Reimprima com módulos escuros sobre uma área clara e lisa para que ele seja lido imediatamente.
Papéis com brilho ou semibrilho refletem a luz diretamente na câmera do celular, e a iluminação de casamentos é composta quase inteiramente por pontos de luz: velas, varais de luz, refletores. Um único reflexo sobre o código já impede a leitura. Reimprima em [papel fosco](/guides/printed-qr-cards), que não reflete dessa maneira.
Às vezes, mas é melhor não arriscar. Um vinco, rasgo ou ondulação no meio do desenho quebra os módulos necessários para a leitura, e até uma pequena obstrução pode impedir o escaneamento. [Reimprima ou troque o cartão](/guides/printed-qr-cards) em vez de apenas desamassar e torcer para dar certo.
O Android 9 e versões posteriores geralmente contam com suporte nativo para leitura de QR code pelo app de câmera ou pelo Google Lens, mas isso varia de acordo com a marca. Fabricantes como Samsung e OnePlus, entre outros, podem deixar a opção oculta nos menus de configuração em vez de ativada por padrão, e alguns modelos de entrada não oferecem o recurso mesmo em versões recentes do Android. Se a câmera do convidado não escanear, oriente-o a usar o Google Lens.
Apenas quando o próprio código é exibido digitalmente, e não quando o celular que faz a leitura está no modo escuro. Um QR code exibido em um site de casamento, em uma mensagem de texto ou em uma imagem salva pode ter as cores invertidas pelo modo escuro forçado, e um código invertido não será lido. O Chrome 141 apresentou uma falha documentada que causava exatamente isso em imagens de alguns sites, incluindo QR codes. Se um código digital falhar, use o cartão impresso.
Tirar um print de um QR code e encaminhá-lo por aplicativos de mensagens comprime a imagem, muitas vezes mais de uma vez com perda de qualidade. Detalhes importantes acabam se perdendo, fazendo com que a resolução fique abaixo do que o leitor precisa para focar. Envie aos convidados o arquivo original ou o cartão impresso em vez de um print encaminhado.
Os iPhones leem QR codes nativamente pelo app Câmera integrado a partir do iOS 11, sem necessidade de aplicativos extras, a menos que a opção em Ajustes > Câmera tenha sido desativada. No Android, o suporte nativo varia conforme o fabricante; por isso, um aplicativo leitor dedicado ou o Google Lens é uma alternativa confiável quando a câmera padrão não funcionar. Os [convidados nunca precisam instalar nada](/faq#do-guests-need-an-app-to-share-wedding-photos) para abrir o álbum.
Imprima um cartão no tamanho final e no papel que planeja usar. Em seguida, escaneie com um iPhone e um Android sob uma iluminação tão suave quanto a que terá na recepção. Faça isso antes de enviar o pedido para a gráfica, e não depois. [Nosso guia de posicionamento](/guides/qr-code-placement) mostra onde colocar cada cartão aprovado e quantos encomendar.
Algumas dessas falhas decorrem da impressão, e nenhuma alteração no software consegue corrigi-las. Linhas horizontais ou falhas de impressão são um exemplo. Outros exemplos são um arquivo de baixa resolução ampliado além do seu tamanho original ou uma tiragem em que o gerenciamento de cores da própria impressora puxou o "preto" para um cinza-escuro quente. Esses três casos se originam na impressão e não funcionam independentemente de onde o cartão seja colocado ou iluminado. A única solução é reimprimir a partir de um arquivo correto, testando novamente antes de rodar o lote completo.
O teste com dois celulares e iluminação real que teria evitado a maioria desses problemas está em nosso guia de cartões com QR code impressos. Imprima um cartão e escaneie-o com um iPhone e um celular Android sob a luz mais fraca que a recepção terá. Faça o mesmo teste com o cartão corrigido antes de substituir todos os cartões nas mesas.
O Chrome 141 apresentou uma falha no modo escuro forçado que inverteu imagens, incluindo códigos QR, em alguns sites em outubro de 2025.
O tamanho mínimo de 2x2 cm, a margem de segurança de quatro módulos e a proporção de distância de escaneamento de 10:1 usados em toda esta página correspondem aos números já confirmados em nosso guia de posicionamento. A mesma fonte abrange a compatibilidade de escaneamento nativo do iOS 11+ e do Android 9+, incluindo variações entre fabricantes, mencionadas acima.
Assim que a correção for aprovada nesse teste, faça um novo pedido a partir de um modelo limpo em vez de reimprimir o mesmo arquivo com defeito, e verifique onde o novo cartão deve ficar antes de colocá-lo de volta nas mesas.
Um único código QR impresso, sem app para os convidados, com fotos e vídeos em resolução máxima em um só álbum para sempre com você.
Prefere texto simples? Leia a versão em markdown.