Leitor e Decodificador de Pix Copia e Cola
Cole um código Pix Copia e Cola, ou envie a imagem do QR Code, para ver cada campo do BR Code e conferir a estrutura e o CRC. Serve para depurar a integração de Pix e para saber o que um QR de terceiro está pedindo.
O código é lido só no seu navegador. Nada é enviado para servidor nenhum, nem a URL de um QR dinâmico é aberta, e o conteúdo some quando você fecha a página.
Código válido
A estrutura, os valores e o CRC conferem.
CRC16
CRC válido- Informado
- 1D3D
- Esperado
- 1D3D
Nenhum erro encontrado.
Resumo do código
- Recebedor
- Fulano de Tal
- Cidade
- BRASILIA
- Tipo de QR Code
- Estático
- Chave Pix
- 123e4567-e12b-12d1-a456-426655440000
- Tipo da chave
- Chave aleatória (EVP)válida
- Valor
- Sem valor fixo: quem paga digita o valor.
- Identificador (txid)
- Não informado (***)
- Categoria do recebedor (MCC)
- 0000
Todos os campos
Cada linha é um campo do código: ID, nome, tamanho declarado e valor. Os templates mostram os sub-campos recuados logo abaixo.
| ID | Nome | Tam. | Valor |
|---|---|---|---|
| 00 | Versão do payload | 2 | 01 |
| 26 | Conta Pix (Merchant Account Information) | 58 | |
| 26.00 | GUI do Pix | 14 | br.gov.bcb.pix |
| 26.01 | Chave Pix | 36 | 123e4567-e12b-12d1-a456-426655440000 |
| 52 | Categoria do recebedor (MCC) | 4 | 0000 |
| 53 | Moeda | 3 | 986 |
| 58 | País | 2 | BR |
| 59 | Nome do recebedor | 13 | Fulano de Tal |
| 60 | Cidade do recebedor | 8 | BRASILIA |
| 62 | Dados adicionais | 7 | |
| 62.05 | Identificador da transação (txid) | 3 | *** |
| 63 | CRC16 | 4 | 1D3D |
Está testando um checkout com Pix e cartão? Gere cartões de crédito de teste.
Quer conferir o número de um cartão com o algoritmo de Luhn?
A API do seu PSP usa token JWT? Veja o conteúdo e a validade dele.
Como usar o Leitor de Pix Copia e Cola?
Cole o código
Copie o Pix Copia e Cola do app do banco, de um PDF ou de uma conversa. As quebras de linha entram sem problema e são removidas sozinhas.
Ou envie o QR Code
No Chrome e em navegadores baseados nele, arraste a imagem do QR Code. O texto lido vai para o campo.
Leia o resumo e os campos
Veja recebedor, chave, valor e txid, e abra a tabela para conferir cada campo com ID, tamanho e valor.
Corrija pelo que o erro aponta
Cada erro traz a posição do caractere. Se o CRC não bate, a ferramenta mostra o valor que ele deveria ter.
O que é o BR Code do Pix?
BR Code é o padrão do Banco Central para QR Codes de pagamento no Brasil. Ele adapta o EMV QRCPS-MPM, usado por carteiras e maquininhas no mundo todo, e o Pix Copia e Cola é o mesmo texto que está dentro do QR Code, só que para copiar em vez de escanear.
Como o código é montado
O texto é uma sequência de campos no formato TLV: 2 dígitos de ID, 2 dígitos com o tamanho do valor e depois o valor. Alguns campos são templates, e o valor deles é outra sequência de campos no mesmo formato.
5913Fulano de Tal- 59: ID do nome do recebedor
- 13: o valor tem 13 caracteres
- Fulano de Tal: o valor
Campos que você vai encontrar
- 00: versão do payload, sempre 01.
- 01: método de iniciação, 11 para QR reutilizável e 12 para uso único.
- 26: conta Pix. Dentro dele ficam o GUI br.gov.bcb.pix (00), a chave (01), uma informação adicional (02) e, no QR dinâmico, a URL do payload (25).
- 52: categoria do recebedor (MCC), 0000 quando não informada.
- 53: moeda, 986 para o real.
- 54: valor, com ponto e duas casas. Pode não existir.
- 58: país, BR.
- 59: nome do recebedor, até 25 caracteres.
- 60: cidade do recebedor, até 15 caracteres.
- 62: dados adicionais. O sub-campo 05 é o txid, e *** quer dizer que não há um.
- 63: CRC16, sempre o último campo.
QR estático e QR dinâmico
Estático
Leva a chave Pix dentro do próprio código, no campo 26 sub-campo 01. O valor é opcional. Serve para cobranças simples e repetidas, e quem recebe só descobre o pagamento pelo extrato ou pelo txid, quando há um.
Dinâmico
Leva no lugar da chave uma URL (campo 26 sub-campo 25) que aponta para o payload no PSP do recebedor. Valor, vencimento, juros e identificação da cobrança ficam lá, e o app do pagador consulta essa URL ao ler o código. Por isso o QR dinâmico costuma ser de uso único (campo 01 igual a 12).
Esta página só lê o que está dentro do código. Para um QR dinâmico, ela mostra a URL e não a acessa.
Como o CRC é calculado
O CRC16 protege o código contra erro de digitação e de cópia. O algoritmo é o CRC16-CCITT-FALSE: polinômio 0x1021 e valor inicial 0xFFFF, aplicado sobre todos os caracteres do código até o 6304 inclusive, ou seja, sem os 4 caracteres do próprio CRC. O resultado vai em 4 caracteres hexadecimais maiúsculos.
Como o cálculo depende da ordem e do conteúdo de cada caractere, trocar uma letra do nome ou um dígito do valor já muda o CRC esperado. Ele detecta alteração acidental e não serve como segurança: quem altera o código pode recalcular o CRC.
Para o exemplo do Manual do Banco Central, o CRC dos caracteres até 6304 é 1D3D.
O que fica no navegador
A decodificação é uma função que roda na própria página, e a leitura de QR por imagem usa a API de detecção de códigos do navegador. O código, a imagem e a chave Pix não passam por servidor nosso nem de terceiros, e os eventos de uso não carregam nenhum desses dados. Ainda assim, um Pix Copia e Cola real tem nome e chave de uma pessoa, então prefira códigos de teste quando for compartilhar a tela.
Perguntas Frequentes sobre o Leitor de Pix Copia e Cola
O que costuma aparecer ao ler e depurar códigos Pix.