Saltar para o conteúdo principal
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.

Criar a ligação com um URL de redirecionamento

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