https://dev.gerencianet.com.br/docs/notificacoes-recebendo
Quando você cria o boleto você pode definir uma URL de retorno no parâmetro metadata>notification_url
Desta forma, automaticamente nossa API dispara um POST para esta URL a cada mudança no status da cobrança. Essa notificação possui um token específico, que será o mesmo durante todo o "ciclo de alterações" da transação. Por exemplo:
Foi gerada uma cobrança. Seu sistema recebe um POST da Gerencianet contendo o token de notificação 09027955-5e06-4ff0-a9c7-46b47b8f1b27 e informando o status da transação - neste caso, waiting;
Posteriormente, essa mesma cobrança teve o pagamento confirmado, então, o status muda para paid e novamente seu sistema recebe uma notificação, ainda com o mesmo token 09027955-5e06-4ff0-a9c7-46b47b8f1b27.
Então sempre que sua aplicação receber notificações, deve-se consultar o token para obter os dados atualizados da transação.
https://dev.gerencianet.com.br/docs/notificacoes-recebendo#21-exemplos-de-respostas