O Bank Link da Didit devolve a pessoa ao seu site quando ela termina, se a sua ligação incluir um redirect_url que a Didit aceite. Sem esse parâmetro, a pessoa termina na página de resultados da própria Didit, e você fica a saber o resultado através do webhook bank.link.completed ou de uma consulta à ligação.
Que endereços funcionam atualmente
Numa aplicação de sandbox, um endereço http simples em localhost, 127.0.0.1 ou [::1] (qualquer porta, qualquer caminho, sem credenciais e sem fragmento) funciona como redirect_url sem necessidade de registo.
Qualquer outro endereço é recusado com 400 redirect_url_not_registered ao criar a ligação.
O registo de outros endereços de retorno ainda não está disponível.
Quando a ligação for concluída, o navegador vai para redirect_url automaticamente, alguns segundos após o último ecrã, com link_id, status e um state assinado.
Se o utilizador final cancelar ou recusar, fica na página de resultados da Didit, que tem um botão para regressar ao seu endereço com status=failed.
Use estes parâmetros para mostrar uma página: servem apenas para apresentação.
A fonte de verdade é o webhook e GET /v3/bank/links/{id}/.
Confirmar sempre no seu servidor
Independentemente do que o navegador lhe indicar, confirme com GET /v3/bank/links/{id}/ ou com o evento de webhook bank.link.completed, usando o identificador da ligação que guardou para esse utilizador.
Relacionados
Última modificação em 22 de novembro de 2026