logo
QR CodesComeçando•

Escolha entre QR Code dinâmico e estático

QR Code dinâmico codifica um link curto que você troca e mede; o estático grava o conteúdo na imagem. Franquia por plano e como converter.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Este artigo explica o que a CodeQR coloca dentro de um QR Code dinâmico e de um estático, o que isso muda para editar, medir e imprimir, como cada formato conta na franquia do plano e como transformar um código estático em dinâmico. Não trata do QR Code Pix dinâmico dos bancos: aqui, "dinâmico" é o código de link editável usado em campanhas e impressos.

Disponibilidade

  • Plano: os dois formatos em todos os planos. A franquia mensal por plano está na tabela abaixo.
  • Onde: a escolha é o primeiro passo de Criar QR Code (Selecione o formato do QR Code). Um código estático existente pode ser convertido na sua página de Editar.

O que cada formato codifica

Dinâmico — a imagem codifica um link curto no seu domínio, por exemplo https://qrup.link/iVx0OCFyDn79-qr. A leitura abre esse link e a CodeQR redireciona o visitante para o destino que você definiu (um redirecionamento 302 para códigos de URL; uma página com o conteúdo para Wi-Fi, cartão de visita e outros tipos). Como a imagem nunca muda, você pode:

  • trocar o destino ou o conteúdo depois de imprimir;
  • ver cada leitura em Análise (por dia, país, dispositivo);
  • usar opções que dependem de servidor: senha, data de validade, Regras inteligentes e formulário de pré-redirecionamento (Business), monitoramento de conversão (Pro), passes de carteira (Pro).

Estático — a imagem codifica o próprio conteúdo: a URL, mailto:, tel:, uma string WIFI:, um vCard, um payload Pix ou um link wa.me. A leitura não passa pela CodeQR, então:

  • funciona sem depender da sua conta, do plano ou do domínio;
  • nada é medido — sem leituras, sem Análise;
  • o conteúdo é fixo depois de impresso. Você pode editar o registro e exportar uma imagem nova, mas toda cópia já impressa continua com o conteúdo antigo;
  • códigos Pix são só estáticos (os apps de pagamento leem o payload Pix direto).

O diálogo resume em uma linha cada: Dinâmico — "A imagem aponta para um link curto. Troque o destino quando quiser — inclusive depois de imprimir." Estático — "O conteúdo fica gravado na imagem. Você pode editar e gerar de novo, mas os códigos já distribuídos seguem com o conteúdo antigo."

Como cada formato conta no plano

  • Free — QR Codes por mês: 5 · Leituras rastreadas por mês: 1.000 · Códigos estáticos: contam nos 5
  • Starter — QR Codes por mês: 150 · Leituras rastreadas por mês: 6.000 · Códigos estáticos: contam nos 150
  • Pro — QR Codes por mês: 1.000 dinâmicos · Leituras rastreadas por mês: 30.000 · Códigos estáticos: ilimitados
  • Business — QR Codes por mês: 5.000 dinâmicos · Leituras rastreadas por mês: 150.000 · Códigos estáticos: ilimitados

A retenção de Análise cresce com o plano (Free 30 dias, Starter 90 dias, Pro 1 ano, Business e acima por mais tempo) — veja preços. Quando a franquia acaba, Criar QR Code fica desabilitado com "Você atingiu seu limite de QR Codes" e a API responde 403 "You have reached the monthly limit of {N} qrcodes on the {Plan} plan. Please upgrade to add more QR Codes." Os códigos existentes continuam funcionando.

Como escolher

  • Tiragens, embalagens, sinalização, cardápios, cartões de visita, qualquer coisa que você não reimprime quando quer: dinâmico. Você vai querer corrigir um erro, mover uma campanha ou contar leituras depois.
  • Conteúdo pontual que precisa funcionar sem depender de internet e nunca muda — a senha do Wi-Fi na parede, uma cobrança Pix, um vCard impresso uma vez: estático.
  • Na dúvida: crie dinâmico. Nunca dá para transformar uma imagem dinâmica em estática sem reimprimir, mas dá sempre para manter o mesmo link curto e trocar o que está atrás dele.

Transforme um código estático em dinâmico

Só essa direção é oferecida. O registro mantém a chave e o link curto; a partir do salvamento, a imagem que você exportar codifica esse link curto em vez do conteúdo.

  1. Abra QR Codes, abra o menu do card (⋮) do código estático e clique em Editar.
  2. Na caixa Transformar em QR Code dinâmico, clique em Transformar em dinâmico. A caixa muda para "Vai virar dinâmico ao salvar"; Manter estático desfaz.

Edit page of a static QR code showing the box Turn this into a dynamic QR code with the button Turn into dynamic

  1. Clique em Save QR Code (o botão do painel de visualização aparece em inglês).
  2. Exporte a imagem de novo e substitua as cópias impressas. As cópias impressas antes da conversão continuam com o conteúdo antigo — a conversão não alcança essas cópias.

No Pro e acima, o código convertido passa a contar na franquia de dinâmicos (+1); no Free e no Starter nada muda, porque os estáticos já contavam.

Pela API, envie PUT https://api.codeqr.io/qrcodes/{qrcodeId} com { "static": false }. Resposta (resumida): mesma key, "static": false, novo updatedAt:

{
  "id": "cmsx87acu0001biopp3dxhgt5",
  "domain": "qrup.link",
  "key": "IUj83vmfuYFE-qr",
  "url": "https://example.com/menu",
  "static": false,
  "shortLink": "https://qrup.link/IUj83vmfuYFE-qr",
  "updatedAt": "2026-08-17T12:45:53.141Z"
}

Na API, static tem padrão false; envie "static": true explicitamente para criar um código estático. O servidor MCP cria só códigos dinâmicos.

Editando um código estático

Quando você muda o conteúdo de um código estático e clica em Save QR Code, o editor mostra o modal Isso muda o que o QR Code codifica, com duas colunas, O que já está impresso e O que passa a valer, e o botão Salvar mesmo assim. É um lembrete, não um bloqueio: depois de salvar, exporte e reimprima.

As opções listadas em Opcional (senha, validade, monitoramento de conversão, webhooks) só valem para códigos dinâmicos. Num código estático elas não têm efeito, porque a leitura nunca chega à CodeQR.

Como verificar

  • Dinâmico: curl -sI https://qrup.link/IUj83vmfuYFE-qr | grep -i location devolve location: https://example.com/menu (ou a página de exibição para tipos que não são URL). O card mostra o selo Dinâmico e um contador de leituras.
  • Estático: decodifique a imagem com qualquer app leitor — ele mostra a sua URL ou conteúdo diretamente, e o card mostra o selo Estático sem contador.

Solução de problemas

Editei um código estático e as cópias impressas ainda abrem a página antiga

Esperado: a URL está dentro da imagem impressa. Converta o código em dinâmico e reimprima uma vez; as próximas mudanças não precisarão de reimpressão.

As leituras do meu código estático estão sempre em zero

Códigos estáticos não são medidos — nada passa pela CodeQR quando são lidos. Converta em dinâmico e reimprima para começar a contar.

Quero que um código dinâmico vire estático

Não é oferecido: uma imagem dinâmica já distribuída codifica o link curto, então "torná-la estática" seria só uma imagem nova e diferente. Crie um novo código estático e imprima.

A API criou um código dinâmico quando eu queria estático

static tem padrão false na API. Envie "static": true.

Artigos relacionados