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

# Link bancario ospitato: invia un link, senza codice nella tua pagina

> Crea un link sul tuo server e invia la persona al suo URL. Didit ospita ogni schermata e può riportarla al tuo `redirect_url` al termine.

Il Bank Link ospitato di Didit è il modo attuale per collegare una banca: crei un link, invii la persona al suo `url` e Didit mostra tutte le schermate sulla propria pagina.
I dati bancari sono disponibili per le applicazioni in sandbox; le chiamate di un'applicazione in produzione restituiscono `404` finché l'accesso in produzione non viene annunciato.

## Crea il link e invialo alla persona

```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": "ongoing",
    "country": "ESP",
    "data": ["accounts", "balances", "transactions"],
    "end_user": { "reference": "client-7731" },
    "vendor_data": "client-7731"
  }'
```

Reindirizza il browser all'`url` presente nella risposta, oppure inseriscilo in un'email o in un messaggio.
L'`url` viene restituito solo al momento della creazione del link e smette di funzionare quando il link scade (60 minuti per impostazione predefinita, da 5 minuti a 24 ore con `expires_in`).

## Cosa succede alla fine

* Con un `redirect_url` accettato da Didit, il browser torna a quell'URL. Vedi [Torna al tuo sito](https://docs.didit.me/it/integration/bank-link/return-to-your-site.md).
* Senza, il flusso termina sulla pagina dei risultati di Didit.
* In entrambi i casi, il webhook `bank.link.completed` e `GET /v3/bank/links/{id}/` ti comunicano il risultato.

## Conferma sul tuo server

Quando arriva `bank.link.completed`, chiama `GET /v3/bank/links/{id}/` con l'ID del link che hai salvato per quell'utente.
La risposta restituisce `status: completed` con il `connection_id`, oppure un errore definitivo con un `error.code`.
Poi prosegui con la [guida introduttiva](https://docs.didit.me/it/core-technology/bank-verification/quickstart.md#passaggio-4-ricevi-i-webhook-e-conferma).


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