↔️Entendendo o fluxo das notificações

Entendendo o fluxo das notificações (callbacks) da API 4P Finance.

Esta página tem como objetivo apresentar as Notificações ( callbacks ). Este recurso está disponível na API de sua conta 4P Finance e permite visualizar os POSTs que a 4P Finance dispara para a URL de retorno definida pelo integrador. Este POST contém apenas uma informação: um token de notificação.

Outras informações sobre o processo de definição da URL de notificação e a mecânica envolvendo a consulta de detalhes de uma notificação podem ser observadas na página Obtendo dados de notificações.

Conhecendo o fluxo de notificações

Assim que é enviado com Sucesso (200) para sua URL de retorno, não significa, por si só, que o fluxo ocorreu completamente. Quando você receber o POST, precisará consultar as informações dessa notificação.

Atenção! O POST que a 4P Finance envia para a sua URL de retorno não contém os dados da transação, mas apenas o token de notificação. Todas as informações sobre a referida transação serão retornadas assim que você consumir o endpoint GET /notification/:token.

O processo de notificação funciona como uma "via de mão dupla", ou seja, a 4P Finance dispara um POST para a sua URL de retorno após confirmada a transação/transferência na blockchain, em seguida, o seu sistema, em posse do token de notificação, envia uma requisição de consumo ao endpoint GET /notification/:token, em que :token é o token de notificação contido no POST enviado.

O fluxo é determinado pela seguinte ordem:

1. A 4P Finance dispara o POST contendo o token de notificação para a URL de retorno cadastrada quando você criou a transação, após a 4P Finance confirmar a transação na blockchain.

2. Sua URL recebeu o POST, fazendo com que seu sistema envie uma requisição GET para a rota /notification/:token, em que :token será o token de notificação que enviamos para você.

Importante! Se o seu sistema consulta o token enviado, consideramos que a notificação foi realizada com sucesso. Caso não consulte, tentaremos novamente por até 05 dias.

Ou seja, se houver uma requisição ao endpoint GET /notification/:token, entenderemos que você recebeu o POST com o token de notificação e que o consultou, recebendo como resposta todos os dados informativos sobre a confirmação da transação.