Contexto


Nossa plataforma adota o conceito de idempotência em suas operações, especialmente em transações financeiras. Esse conceito garante que, mesmo que uma mesma requisição seja processada múltiplas vezes, o efeito será o mesmo, evitando inconsistências ou registros duplicados.

Esse princípio também se aplica ao envio de callbacks, que podem ser reenviadas em determinadas situações, como falhas de rede ou instabilidade na entrega.


1. Funcionalidades Disponíveis


A plataforma envia callbacks para notificar eventos relacionados a transações. Entre os comportamentos esperados estão:

  • Envio automático de callbacks em caso de eventos de transação;

  • Possibilidade de reenvio de uma mesma callback em caso de falha de entrega;

  • Preservação do mesmo transactionID para todos os envios de uma mesma transação, mesmo em casos de duplicidade.


⚠️ Observações Importantes

  • O reenvio de callbacks é um comportamento esperado e desejável, especialmente em contextos de falha de rede;

  • A responsabilidade de lidar com repetições é da aplicação receptora;

  • O identificador único transactionID permite que o receptor verifique se aquele evento já foi tratado;

  • A ausência de tratamento adequado pode gerar efeitos colaterais, como atualizações duplicadas ou falhas de reconciliação.


Suporte


Para dúvidas ou acompanhamento de chamados, acesse: Portal de Suporte