O que é um decodificador de Pix copia e cola?
Um decodificador de Pix copia e cola é uma ferramenta que lê o texto de um QR Code Pix (o payload BR Code) e o separa nos campos definidos pelo Banco Central do Brasil: identificador de formato, método de iniciação, bloco da conta com a chave Pix, categoria, moeda, valor, país, nome, cidade, identificador da transação e CRC. Ele também recalcula o CRC16 para dizer se o código está íntegro. Tudo roda no seu navegador; o texto colado não é enviado a lugar nenhum.
Como usar
- Copie o Pix copia e cola que você recebeu, ou extraia o texto de um QR Code com a câmera ou um leitor genérico.
- Cole no campo acima e clique em Decodificar. Quebras de linha são ignoradas; espaços internos do nome são preservados.
- Leia o resultado: situação do CRC, se é um código Pix (GUI
br.gov.bcb.pix), estático ou dinâmico, chave e tipo de chave, nome, cidade, valor, txid e a árvore TLV completa.
O que cada campo quer dizer
| ID | Campo | Valor no código estático |
|---|---|---|
| 00 | Payload Format Indicator | 01, sempre |
| 01 | Point of Initiation Method | omitido ou 11 (reutilizável); 12 = uso único |
| 26 | Merchant Account Information | subcampo 00 = br.gov.bcb.pix, 01 = chave, 02 = descrição opcional |
| 52 | Merchant Category Code | 0000 quando não há categoria |
| 53 | Transaction Currency | 986 = real brasileiro (ISO 4217) |
| 54 | Transaction Amount | opcional; ponto decimal, até 2 casas, ex. 25.90 |
| 58 | Country Code | BR |
| 59 | Merchant Name | nome do recebedor, até 25 caracteres ASCII |
| 60 | Merchant City | cidade, até 15 caracteres ASCII |
| 62 | Additional Data Field | subcampo 05 = txid (até 25 alfanuméricos) ou *** |
| 63 | CRC | CRC16-CCITT (polinômio 0x1021, inicial 0xFFFF) de tudo o que vem antes, inclusive 6304 |
Exemplo prático
Clique em "Usar o exemplo do Banco Central" para carregar o código do manual oficial. O resultado mostra CRC válido (1D3D), arranjo Pix, tipo estático reutilizável, chave aleatória 123e4567-e12b-12d1-a456-426655440000, nome Fulano de Tal, cidade BRASILIA, valor não definido e txid ***. Troque o último caractere por qualquer outro e decodifique de novo: o CRC passa a inválido, que é exatamente o que o app do pagador faria.
Estático, estático de uso único e dinâmico
| Tipo | Como reconhecer | Quem pode gerar |
|---|---|---|
| Estático reutilizável | Campo 01 ausente ou 11; chave no 26-01 | Qualquer pessoa, inclusive este site |
| Estático de uso único | Campo 01 = 12; chave no 26-01 | Qualquer pessoa; o app pode recusar reutilização |
| Dinâmico | Campo 01 = 12 e URL do PSP no 26-25 | Só o banco ou PSP da conta, via API, com payload assinado |
Usos comuns
- Antes de pagar: conferir se a chave e o nome do código enviado por um desconhecido batem com o que foi combinado. Lembre que o nome no código é digitado por quem o gerou; o nome de verdade aparece na tela do app, vindo do DICT.
- Antes de imprimir: validar o código da sua placa de loja, gerado aqui ou em outro lugar.
- Suporte e desenvolvimento: encontrar o campo com tamanho errado em um código recusado, ou verificar se um sistema está gravando o valor com ponto e duas casas.
Limites desta ferramenta
O decodificador valida a estrutura e o CRC. Ele não sabe se a chave está cadastrada, se a conta existe, se um código dinâmico já foi pago ou se a URL do payload está ativa, porque nada disso está no texto e nenhuma dessas consultas é possível fora de uma instituição participante do Pix. Para saber se uma chave é válida em formato e se os dígitos de CPF ou CNPJ conferem, use o validador de chave Pix. Para criar o seu próprio código, use o gerador de QR Code Pix.
Referências
Banco Central do Brasil, Manual de Padrões para Iniciação do Pix; EMVCo, EMV QR Code Specification for Payment Systems, Merchant Presented Mode (estrutura TLV e CRC).