Pix: o que os identificadores registram sobre uma cobrança e seu pagamento

Mapa rápido: cobrança, pagamento e conciliação

O Manual de Padrões para Iniciação do Pix do Banco Central distingue a cobrança do pagamento efetuado para quitá-la. Na API Pix, o txid é o identificador da cobrança na perspectiva do usuário recebedor e permite associar pagamentos à cobrança correspondente. O EndToEndId (também chamado identificador fim a fim) identifica a transação de pagamento que circulou no arranjo. São campos relacionados, mas com funções diferentes.

Um txid não é comprovante bancário. Ele pode existir antes do pagamento porque identifica uma cobrança criada. Da mesma forma, o EndToEndId ajuda a localizar um pagamento, mas um texto copiado sem consulta ao PSP não comprova que o valor entrou na conta da lavanderia. Conciliação deve combinar identificadores com valor, data, recebedor, conta e situação de crédito.

O que o txid faz — e o que não faz

Na cobrança dinâmica criada pela API Pix, o txid é informado para identificar a cobrança e permitir conciliação. O manual do Banco Central explica que o txid é, em geral, criado pelo usuário recebedor e fica sob sua responsabilidade; em cobrança imediata, pode haver delegação de geração ao PSP recebedor. Para cobrança criada pela API, o manual exige unicidade para determinado recebedor no PSP, segundo as regras ali descritas. Fonte de referência: BCB — Pix: cobrança.

Na prática, um sistema de lavanderia pode associar um txid à cobrança de uma compra ou serviço. Quando o pagamento é identificado, o sistema procura o vínculo para atualizar o registro interno. Esse desenho depende da integração e da forma de pagamento. QR estático pode não oferecer a mesma identificação estruturada; se o campo não existe, o operador talvez precise conciliar com outros dados. Não invente o txid olhando apenas um comprovante ou nome de pagador.

Um identificador de cobrança também não informa sozinho qual máquina deve iniciar um ciclo. O registro pode apontar para a cobrança certa, mas a liberação de equipamento depende da integração entre PSP, software e controlador da lavanderia. Esse fluxo de automação é aprofundado em um guia sobre pagamento. Aqui a distinção é documental: identificador localiza ou vincula registros, enquanto o estado de liquidação confirma o pagamento conforme os dados do PSP recebedor.

O papel do EndToEndId no comprovante

O Banco Central define o identificador da transação no comprovante Pix como referência ao EndToEndId da mensagem de pagamento. O manual de experiência do usuário descreve também informações como valor e data e hora da liquidação, além do txid quando preenchido. Isso permite que pagador, recebedor e suporte encontrem a mesma operação nos registros da instituição participante. Se houver divergência, forneça o identificador ao PSP pelo canal autenticado de atendimento. Fonte de referência: BCB — Manual de Padrões para Iniciação do Pix.

O comprovante é evidência emitida pelo prestador de serviços de pagamento, mas uma imagem ou PDF enviado por mensagem pode ser falso, alterado ou se referir a outra transação. Para saber se a conta da unidade recebeu o recurso, consulte o aplicativo ou extrato da conta recebedora, ou a integração oficial que informa liquidação/crédito. Confirme recebedor, valor, momento e identificador. Não libere produto ou ciclo com base apenas em captura de tela que o cliente apresenta.

O txid e o EndToEndId podem aparecer juntos, mas não devem ser confundidos. O txid ajuda a ligar um pagamento a uma cobrança. O EndToEndId ajuda a localizar a transação. O recibo comunica informações da operação, enquanto o extrato e o retorno do PSP recebedor permitem confirmar o crédito. Mantenha ambos no registro de conciliação se o seu sistema os disponibilizar.

Estado da cobrança não é estado do pagamento

A API Pix representa recursos diferentes: cobrança, pagamento, devolução e notificação. O manual distingue o estado da cobrança do estado do Pix relacionado. Uma cobrança pode ser criada e permanecer aguardando pagamento; em outros casos, pode ser removida, vencida ou marcada como concluída segundo campos e regras da API. “Concluída” pode se referir ao ciclo de vida da cobrança, não à obrigação comercial ou a um pagamento confirmado, então leia o campo e a definição técnica exatos. Fonte de referência: BCB — Requisitos Mínimos para Experiência do Usuário Pix.

Para uma cobrança dinâmica, o sistema recebedor pode consultar a situação da cobrança e os pagamentos associados. O manual também descreve webhook como recurso técnico pelo qual o PSP recebedor informa o recebedor quando um Pix associado a um txid é creditado. Isso só é útil se a empresa usa uma integração corretamente implementada, autenticada, monitorada e capaz de tratar falhas de comunicação e mensagens duplicadas.

Não tome uma tela “pago” do aplicativo da própria lavanderia como prova definitiva sem entender a origem dessa informação. Ela pode vir de integração, lançamento manual ou regra interna. Para cada ciclo, guarde qual evento ou retorno autorizou a liberação, identificadores, valor e hora. Se a plataforma ficar indisponível ou o webhook atrasar, estabeleça procedimento de exceção que não permita liberar serviço duas vezes nem negar pagamento já creditado.

Como fazer a conciliação de um recebimento

Uma conciliação confiável cruza a cobrança interna com o registro do PSP recebedor. Use txid, quando existir; EndToEndId da transação; valor; moeda; horário; recebedor; estado reportado pela API e lançamento no extrato. Verifique se existe devolução parcial ou total e não conte devolução como novo recebimento. Se a cobrança não tinha txid, documente qual chave alternativa fez a correspondência, como valor e janela de tempo, sem tratar isso como garantia de identidade. Fonte de referência: BCB — Pix: cobrança.

Defina tratamento para pagamento duplicado, valor divergente, cobrança expirada, QR reutilizado, devolução solicitada e estado desconhecido. Uma política segura distingue “aguardando confirmação” de “crédito confirmado” e de “erro de consulta”. Não marque pago apenas porque a requisição de criação da cobrança respondeu com sucesso: criação de cobrança e transferência de recursos são etapas diferentes. Guarde logs com acesso controlado para resolver disputa, respeitando privacidade e retenção necessária.

Teste a integração com casos normais e de exceção antes de conectar à liberação automática. Confirme como o PSP documenta credenciais, notificações, consulta e repetição de solicitações. Se uma reconciliação não bater, não altere à mão o estado sem manter trilha de auditoria e justificativa. Encaminhe o EndToEndId ao provedor pelo canal oficial e espere confirmação da instituição recebedora.

Quadro de decisão para o operador

Esse quadro não substitui o manual técnico do PSP. O formato de consulta, credencial, retorno e tratamento de erros depende do contrato e da versão da API utilizada. Se a lavanderia usa terminal, aplicativo ou software de terceiro, solicite ao fornecedor explicação documentada sobre qual evento autoriza uma venda e como a unidade pode auditar recebimentos sem acessar informação de outros clientes. Fonte de referência: BCB — Manual de Padrões para Iniciação do Pix.

O que registrar para suporte e auditoria

Guarde a relação entre referência comercial, txid quando existente, EndToEndId, valor, data e hora, status, máquina ou ponto de venda, retorno da API e lançamento bancário. Salve a versão do software e do contrato do PSP, além dos contatos de suporte. Esses registros permitem localizar uma divergência sem depender da memória do atendente ou de captura de tela que o pagador compartilhou. Fonte de referência: BCB — Requisitos Mínimos para Experiência do Usuário Pix.

Restrinja os dados pessoais ao necessário. O txid pode ser associado a uma cobrança e, dependendo de como é gerado, conter informação interna; evite incluir CPF, telefone ou dado sensível no campo sem necessidade. Defina quem pode consultar logs, por quanto tempo serão mantidos e como serão protegidos. As regras de privacidade e de segurança dos dados continuam relevantes mesmo quando o objetivo é apenas conciliar pagamentos.

O Banco Central publica versões dos manuais e normas do Pix. Identifique o documento que corresponde à integração usada e revise os comunicados do seu PSP ao atualizar. A matéria foi verificada em 23/10/2026; mudanças futuras podem atualizar campos e fluxos. A SPL não fornece nem recomenda processador de pagamento: compare as opções e valide documentação diretamente com os provedores que a empresa está avaliando.

Ao revisar o relatório, separe quatro momentos que às vezes aparecem numa única tela: criação da cobrança, recebimento da instrução de pagamento, liquidação entre participantes e crédito refletido na conta recebedora. O manual e o PSP determinam quais estados são expostos à integração, e nem todo sistema apresenta a mesma nomenclatura. Documente qual indicador a equipe considera final e quem pode autorizá-lo; assim, a conciliação não depende de interpretar um rótulo interno sem conhecer sua origem.

Perguntas frequentes