> ## 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 di Bank Link: tornare al tuo sito

> Con redirect_url riporti l'utente sul tuo sito dopo Bank Link. Senza, finisce sulla pagina dei risultati di Didit. In sandbox va bene localhost.

Bank Link di Didit riporta la persona sul tuo sito al termine, se il tuo link contiene un `redirect_url` che Didit accetta.
Senza, la persona termina sulla pagina dei risultati di Didit e tu apprendi l'esito dal webhook `bank.link.completed` oppure consultando il link.

## Quali indirizzi funzionano oggi

In un'applicazione sandbox un indirizzo `http` semplice su `localhost`, `127.0.0.1` o `[::1]` (qualsiasi porta, qualsiasi percorso, senza credenziali, senza frammento) funziona come `redirect_url` senza bisogno di registrazione.
Qualsiasi altro indirizzo viene rifiutato con `400 redirect_url_not_registered` quando crei il link.
La registrazione di altri indirizzi di ritorno non è ancora disponibile.

## Crea il collegamento con un URL di reindirizzamento

```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"
  }'
```

Al termine del collegamento, il browser passa automaticamente a `redirect_url` pochi secondi dopo l'ultima schermata, con `link_id`, `status` e uno `state` firmato.
Se la persona annulla o rifiuta, resta sulla pagina dei risultati di Didit, che include un pulsante per tornare al tuo indirizzo con `status=failed`.
Usa questi parametri per mostrare una pagina: hanno solo finalità di visualizzazione.
Il webhook e `GET /v3/bank/links/{id}/` sono la fonte di verità.

## Conferma sempre sul tuo server

Qualunque cosa ti comunichi il browser, conferma l'esito con `GET /v3/bank/links/{id}/` oppure con il webhook `bank.link.completed`, usando l'ID del link che hai memorizzato per quell'utente.

## Correlati

* [Link bancario ospitato](https://docs.didit.me/it/integration/bank-link/hosted-link.md)
* [Avvio rapido](https://docs.didit.me/it/core-technology/bank-verification/quickstart.md)


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