Identificador do Pix (txid): o que é e como usar
Resposta curta: o txid é um identificador que você pode colocar no QR Code Pix estático para reconhecer a cobrança depois. Ele aceita até 25 caracteres, só letras sem acento e números. O Banco Central determina que o banco de quem paga repasse o txid sem alterar, mas não diz que ele aparece no extrato de todo banco. Por isso, use o txid como ajuda, nunca como única prova de pagamento.
Teste por banco pendente. Ainda não fizemos testes de pagamento com txid entre bancos para ver onde o identificador aparece. Este guia não afirma nem nega que ele aparece no extrato de algum banco específico. Quando houver teste, o resultado será publicado aqui com data e banco.
O que é o txid
txid vem de “transaction identifier”, ou identificador da transação. No MandaPix, ele aparece como campo “Identificador”. Segundo o Manual de Padrões para Iniciação do Pix, ele é um identificador que deve ser retransmitido intacto pelo banco de quem paga ao gerar a ordem de pagamento. O objetivo, diz o Manual, é permitir que o recebedor identifique e relacione a transferência recebida com a cobrança que apresentou.
Repare no que isso quer dizer: o identificador viaja junto com o Pix até o banco de quem recebe. O Manual não determina que o app do banco o mostre para você. Isso depende de cada instituição.
O documento Requisitos Mínimos para a Experiência do Usuário, versão 7.3, também do Banco Central, prevê que a notificação de Pix recebido por QR Code e o comprovante tragam a mensagem do campo “Identificador” sempre que ele estiver preenchido. Trata-se de um requisito para aplicativos de pessoa física. Ele orienta como os apps devem se comportar, mas não substitui o teste no seu banco.
Regras no QR estático
- Tamanho: até 25 caracteres.
- Caracteres aceitos: letras minúsculas de a a z, letras maiúsculas de A a Z e números de 0 a 9.
- Não aceitos: espaço, hífen, barra, ponto, acento, cedilha, emoji e qualquer outro símbolo. O gerador do MandaPix remove esses caracteres em vez de recusar o texto: “pedido-18” vira “pedido18”.
- Sem identificador: quando você deixa em branco, o código leva três asteriscos (
***). É o valor padrão do BR Code para indicar que não há identificador. - Repetição: o banco não tem como impedir que o txid se repita em QR estático, porque esses QR não são registrados por ele. O Manual diz que a repetição pode ser desejável, como em um cartaz de valor livre, ou indesejável, como em um QR gerado a cada venda. A consistência fica a cargo de quem recebe.
Se o mesmo QR for usado por várias pessoas, todas as cobranças chegam com o mesmo identificador. Para separar uma da outra, gere um QR por cliente ou por cobrança.
No QR dinâmico, o txid segue outra regra: de 26 a 35 caracteres e único por cobrança. Veja QR estático ou dinâmico.
Exemplos de padrão por uso
O ideal é um padrão simples, que você entenda daqui a um mês, sem dado sensível. Não coloque CPF, telefone, nome completo nem qualquer informação que você não queira que o pagador e os bancos vejam.
| Uso | Exemplos | Lógica |
|---|---|---|
| Diária | casaAna, diaria0930 | Nome curto da casa ou dia e mês |
| Aluguel | apto12ago26, aluguel202609 | Imóvel e mês de referência |
| Pedido | pedido18, kitAna | Número do pedido ou nome curto do produto |
| Cota ou campanha | reforma01, cesta03 | Campanha e sequência |
Evite identificadores curtos demais, como 1 ou a, que se confundem com outros. Também evite letras parecidas com números.
Se você organiza uma rifa autorizada, o identificador pode conter o número do bilhete. Antes, leia Rifa é legal no Brasil?
O txid aparece no extrato? Teste em bancos
O que se sabe por fonte oficial:
- O banco de quem paga deve repassar o txid intacto.
- Pelos Requisitos Mínimos do Banco Central, a notificação de recebimento por QR Code e o comprovante devem trazer o campo “Identificador” quando ele estiver preenchido.
- Nada disso descreve como cada banco organiza o extrato ou a busca. Cada app pode mostrar o identificador em um lugar, ou não mostrar em determinadas telas.
O que ainda não foi verificado: em quais bancos o identificador aparece no extrato, na notificação, no comprovante ou nos filtros de busca. Por isso, o MandaPix não promete que o txid vai aparecer no seu extrato.
Como conferir por conta própria, com dois bancos que você tem: gere um QR de R$ 1,00 com um identificador fácil de reconhecer, como teste01, e pague de uma conta para a outra. Depois procure o identificador no extrato, na notificação e no comprovante dos dois lados. Anote o que viu, porque isso vale só para aquele banco e aquela versão do app.
O Manual prevê que quem tem acesso à API Pix do banco consulte os Pix recebidos por txid. É uma opção para empresas com integração. Para conferir um pagamento no dia a dia, o caminho seguro é abrir o app do banco e ver se o crédito caiu, com o valor e o nome de quem pagou. Não entregue produto nem serviço só com base em print.
Quando deixar em branco (***)
- Cartaz de valor livre, quando você não vai separar as cobranças de qualquer forma.
- Quando o valor é igual e a origem do pagamento não importa.
- Quando você não quer que nenhum dado seu seja repassado, além do necessário.
Para todos os outros casos, um identificador simples ajuda a se organizar, principalmente se você usa uma planilha ou uma lista ao lado do extrato. Os textos das páginas diarista, aluguel e Instagram mostram como aplicar. Para conferir o código gerado, veja Pix copia e cola.
Guias relacionados
Continue lendo: