> ## 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.

# redirect_url do Bank Link: retorno ao seu site

> Redirecione ao seu site após o Bank Link com redirect_url; no sandbox, localhost serve. Sem ele, a Didit mostra a página de resultado.

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.

## Crie o link com uma 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 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

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


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