O txid é o "número do pedido" do Pix do lado de quem cobra. Quando o pagamento chega, é ele que diz a qual cobrança aquele dinheiro pertence. Sem um identificador assim, a conciliação depende de comparar valor e horário, o que falha quando duas cobranças têm o mesmo valor.
Como o txid funciona
Segundo o Manual de Padrões para Iniciação do Pix do Banco Central (versão 2.10.0, de 19/08/2026), o txid é gerado pelo usuário recebedor e repassado ao seu PSP quando a cobrança é criada. Nas cobranças para pagamento imediato, a geração pode ser delegada ao PSP do recebedor. O caminho do txid:
- O app do PSP do pagador lê o txid ao processar a cobrança.
- Confirmado o pagamento, se o recebedor tem conta em outro PSP, o txid segue na mensagem de pagamento para o SPI, o Sistema de Pagamentos Instantâneos.
- O SPI entrega a mensagem ao PSP do recebedor, que informa ao recebedor que aquela cobrança foi liquidada.
As regras de formato do manual:
| Contexto | Regra |
|---|---|
| Cobrança com QR Code dinâmico | De 26 a 35 caracteres. |
| QR Code estático | Campo EMV 62-05, até 25 caracteres: letras de a a z, de A a Z e dígitos. |
| Unicidade | Único por CPF ou CNPJ do recebedor no PSP. |
Na API da xFlow
A documentação da API da xFlow não traz um campo txid. Para ligar a cobrança ao seu pedido, ela oferece dois identificadores:
id: o identificador da cobrança, devolvido no201da criação.external_reference: o id do pedido no seu sistema, com até 120 caracteres. Ele volta em toda resposta e webhook da cobrança e funciona como filtro na listagem.
Para identificar a liquidação, e não a cobrança, a API traz o pix.endToEnd.
Exemplo
curl "https://app.xflowpayments.com/api/v1/charges?external_reference=pedido-1234" \
-u "pk_live_...:sk_live_..."Na sua integração, esse filtro cumpre o papel que o txid tem no arranjo Pix: achar a cobrança a partir do pedido.
Termos relacionados
- End-to-end ID: identifica o Pix liquidado, não a cobrança.
- BR Code: o padrão do QR Code, onde o txid ocupa o campo 62-05 no QR estático.
- PSP: a instituição que recebe o txid e avisa o recebedor.
- Webhook: o aviso que a API manda quando a cobrança é paga.
Conteúdo informativo, atualizado em 25/10/2026. Não substitui orientação jurídica.