> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Bank Link: URL de retorno e redirect_url

> Devolva a pessoa ao seu site após o Bank Link com redirect_url. No sandbox funciona um localhost; sem ele, acaba na página de resultados da Didit.

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

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "one_time",
    "country": "ESP",
    "redirect_url": "http://localhost:3000/bank/return",
    "vendor_data": "client-7731"
  }'
```

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

* [Hosted Bank Link](https://docs.didit.me/pt/integration/bank-link/hosted-link.md)
* [Início rápido](https://docs.didit.me/pt/core-technology/bank-verification/quickstart.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.