O Bank Link da Didit envia a pessoa de volta ao seu site quando ela termina, se o seu link contiver um redirect_url que a Didit aceite.
Sem ele, a pessoa termina na própria página de resultado da Didit, e você fica sabendo do resultado pelo webhook bank.link.completed ou por uma consulta ao link.
Quais endereços funcionam hoje
Em uma aplicação sandbox, um endereço http simples em localhost, 127.0.0.1 ou [::1] (qualquer porta, qualquer caminho, sem credenciais, sem fragmento) funciona como redirect_url sem necessidade de registro.
Qualquer outro endereço é recusado com 400 redirect_url_not_registered ao criar o link.
O registro de outros endereços de retorno ainda não está disponível.
Quando o link é concluído, o navegador vai para redirect_url automaticamente, alguns segundos após a última tela, com link_id, status e um state assinado.
Se a pessoa cancelar ou recusar, ela permanece na página de resultado da Didit, que tem um botão para voltar ao seu endereço com status=failed.
Use esses parâmetros para exibir uma página: eles servem somente para exibição.
O webhook e GET /v3/bank/links/{id}/ são a fonte de verdade.
Sempre confirme no seu servidor
Independentemente do que o navegador informar, confirme com GET /v3/bank/links/{id}/ ou com o webhook bank.link.completed, usando o id do link que você armazenou para esse usuário.
Relacionados
Última modificação em 22 de novembro de 2026