QR Code PIX: um BR Code estático para receber no Brasil
O PIX é o sistema de pagamentos instantâneos do Brasil, e seus QR codes seguem a especificação EMV de pagamento: a mesma gramática de campo e comprimento usada por códigos de cobrança em outros países. Um PIX estático carrega a chave do recebedor direto no símbolo, então o app do banco monta a transferência sem consultar um servidor. Isso barateia a impressão e funciona offline, mas também congela o código.
Como um código PIX estático é estruturado
Cada campo é escrito com um id de dois dígitos, um comprimento de dois dígitos e o valor. O payload começa em 00 e termina com o CRC no campo 63. O campo 26 é o bloco da conta do recebedor, onde o subcampo 00 identifica o arranjo PIX e o subcampo 01 guarda a chave.
| Campo | Valor no exemplo | Função |
|---|---|---|
| 00 | 01 | Indicador do formato do payload. |
| 26 | br.gov.bcb.pix + chave | Informação da conta: GUI do PIX e a chave CPF, CNPJ, e-mail, telefone ou aleatória. |
| 52 | 0000 | Categoria do estabelecimento; 0000 é aceito quando não há categoria. |
| 53 | 986 | Moeda: 986 é o real brasileiro. |
| 58 | BR | Código do país. |
| 59 | QrDeco Example | Nome do recebedor, até 25 caracteres. |
| 60 | Sao Paulo | Cidade do recebedor, até 15 caracteres. |
| 62 | 05 + txid | Dados adicionais: o identificador da transação, ou *** quando não há. |
| 63 | 3C63 | CRC16-CCITT sobre tudo o que vem antes deste campo. |
Gere um PIX com a sua própria chave
- Escolha o tipo de chave que a conta realmente registrou: CPF ou CNPJ só com dígitos, e-mail como escrito, telefone com +55 e o número, ou a chave aleatória (EVP) no formato UUID.
- Preencha os campos 52, 53 e 58 com 0000, 986 e BR.
- Use os campos 59 e 60 com o nome e a cidade que o banco vai exibir; ambos têm limite e não aceitam formatação.
- Calcule o CRC e exporte SVG para impressão ou PNG para uma página de pagamento.
Deixar o valor em aberto
Sem o campo 54, quem paga digita o valor. Com o campo 54 e separador decimal por ponto — 10.50, nunca 10,50 —, o app já preenche. Valores abertos servem para gorjetas, doações e balcões em que o total é combinado antes; valores fixos combinam com uma página de produto ou um serviço de preço único.
O txid e a conciliação
O subcampo 62-05 identifica a transação. O valor *** significa “sem id”, o que serve para um caixa anônimo mas não ajuda a conciliar as vendas do dia. Use um número curto de nota ou pedido, com até 25 caracteres alfanuméricos, e registre qual código foi impresso e quando.
Perguntas frequentes
Um PIX estático é igual a um dinâmico?
Não. O estático contém a chave e os dados fixos; o dinâmico contém uma URL que um serviço de pagamento resolve em uma cobrança, e é assim que valores por nota e vencimento funcionam.
Por que o app do banco rejeita meu código?
Quase sempre é o CRC. Recalcule o campo 63 depois de qualquer edição — inclusive nome, cidade ou txid — e confira se cada comprimento ainda corresponde ao valor.
Posso reutilizar um PIX para todas as vendas?
Sim, para um código estático com valor aberto, mas o txid será o mesmo em todo pagamento a menos que você gere um código por venda. Reutilizar é prático; não é uma estratégia de conciliação.