Pular para o conteúdo
xFlow Payments

Glossário

O que é End-to-end ID

End-to-end ID (EndToEndId) é o identificador único de uma transação Pix na liquidação. Na API da xFlow, ele aparece no campo pix.endToEnd das cobranças pagas e serve, junto com os dados do pagador, para conciliar o recebimento com o extrato.

Atualizado em · Equipe xFlow Payments

O End-to-end ID identifica o Pix em si, do início ao fim do caminho entre as instituições. O txid nasce do lado de quem cobra e identifica a cobrança. O End-to-end ID identifica a transação que de fato liquidou. Uma cobrança tem um txid; cada Pix tem o seu End-to-end ID.

Para que serve no arranjo Pix

O identificador acompanha as mensagens trocadas entre as instituições e é a referência para tudo que acontece depois do pagamento. O exemplo mais claro é a devolução:

  • O Manual de Padrões para Iniciação do Pix (versão 2.10.0, de 19/08/2026) descreve que, para devolver um pagamento, o recebedor identifica o Pix original pelo seu EndToEndId. Na API Pix definida pelo Banco Central, a devolução é pedida em /pix/{e2eid}/devolucao/{id}.
  • O Manual de Fluxos do Processo de Efetivação do Pix (versão 2.1) mostra que, na devolução, o PSP do destinatário recupera com base no EndToEndId a data do pagamento, o valor e os dados da conta.

Na API da xFlow

O campo é pix.endToEnd. Ele vem do PSP na confirmação do pagamento e aparece em:

  • GET /api/v1/charges/{id}, quando a cobrança está paid;
  • a listagem GET /api/v1/charges;
  • o data do webhook transaction.paid.

No evento transaction.pending, ele ainda é null. A documentação recomenda usar pix.endToEnd junto com payer (nome, CPF ou CNPJ e banco de quem de fato pagou) para conciliar com o extrato bancário.

Exemplo

Trecho de uma cobrança paga, como na documentação da API:

json
{
  "status": "paid",
  "payer": { "name": "Fulano de Tal", "document": "10900327570", "bank": "BANCO EXEMPLO" },
  "pix": { "endToEnd": "E18236120202609130426s1894658118" },
  "paidAt": "2026-09-13T04:26:13.927Z"
}

Guarde o valor como texto, junto do pedido. Se precisar estornar ou responder a uma dúvida do cliente, é ele que prova qual Pix entrou. O estorno na API da xFlow é feito pelo id da cobrança, como mostra o artigo sobre estorno Pix por API.

Termos relacionados

  • txid: identifica a cobrança, do lado de quem recebe.
  • PSP: a instituição que informa o End-to-end ID na confirmação.
  • Webhook: o evento transaction.paid traz o campo pix.endToEnd.
  • DICT: o diretório consultado quando o pagador usa uma chave Pix.

Conteúdo informativo, atualizado em 25/10/2026. Não substitui orientação jurídica.

Continue lendo