O que é o EndToEndId?
O EndToEndId é um identificador único que acompanha uma transação Pix de ponta a ponta. Ele é utilizado pelo SPI (Sistema de Pagamentos Instantâneos) e pelas instituições participantes para rastrear, validar e identificar unicamente cada pagamento.
Esse identificador segue um padrão estabelecido pelo Catálogo de Mensagens do Bacen, sendo composto por informações como o ISPB da instituição, data e hora da operação, e um número sequencial ou aleatório.
Validade do EndToEndId
De acordo com as regras do Banco Central, o EndToEndId possui validade de 12 horas em relação ao horário de processamento da transação.
Na prática, o campo de data e hora presente no identificador segue o formato:
yyyyMMddHHmm
Esses 12 caracteres representam a data, hora e minuto (UTC) da submissão da ordem de pagamento (no caso de liquidação imediata) ou da previsão de envio ao sistema de liquidação (em caso de agendamento).
O SPI aceita uma tolerância máxima de 12 horas para frente e para trás em relação ao horário efetivo de processamento da ordem.
Como funciona em casos específicos
1. Pix Imediato (liquidação prioritária)
Para transações enviadas para liquidação imediata, o horário do EndToEndId deve refletir o momento real da submissão da ordem. O SPI aceitará o EndToEndId desde que esteja dentro da janela de 12 horas em relação ao horário de liquidação.
2. Pix Agendado
No caso de Pix Agendado, não é necessário definir o horário exato da liquidação no EndToEndId.
A recomendação é definir um horário fixo dentro da janela de tolerância, por exemplo:
Utilizar 15h (UTC) como hora padrão no EndToEndId do dia da liquidação.
Isso garante que o identificador permaneça válido mesmo que a liquidação ocorra em um horário diferente dentro do mesmo dia.
3. Pix Automático (Pix Pull Request)
Para o Pix Automático, o mesmo princípio se aplica. Mesmo que o envio ocorra junto da solicitação de agendamento, o EndToEndId deve conter o horário das 15h UTC no dia em que a liquidação está prevista para ocorrer.
Dessa forma, evita-se erros de rejeição por parte do banco recebedor devido à expiração da validade do identificador.
Conclusão
Não é necessário que o participante realize uma validação adicional durante o recebimento de um Pix.
A Stark já realiza internamente a verificação dos campos obrigatórios e do formato esperado do EndToEndId conforme as regras do Bacen.
O ponto de atenção principal deve estar no momento da geração do identificador, garantindo que o horário informado esteja dentro da tolerância permitida.
O EndToEndId é essencial para a rastreabilidade das transações Pix e deve sempre respeitar o intervalo de validade de 12 horas estabelecido pelo Bacen. Seguindo a recomendação de usar o horário fixo de 15h UTC em transações agendadas ou automáticas, você garante que suas operações ocorram sem erros de expiração ou rejeição.
Em casos de dúvidas, ficamos à disposição para ajudar!
Comentários
0 comentário
Artigo fechado para comentários.