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

# Verifica bancaria: fallback e continua senza banca

> Con Didit la verifica bancaria non si blocca mai: percorsi alternativi, opzione Continua senza banca, esiti personalizzati e report dei risultati.

La verifica bancaria non lascia mai una persona bloccata. Mentre il passaggio è in attesa, l'utente può sempre selezionare **Continua senza la tua banca**, e il passaggio lo mostra non appena nessun metodo funziona per il suo paese o per la sua banca. La sessione segue quindi l'esito scelto per quel caso, una revisione per impostazione predefinita. Quando un tentativo fallito esaurisce l'ultimo tentativo di ogni modalità ancora a disposizione, compreso il caricamento dell'estratto conto, il passaggio non attende: termina autonomamente e segue `bank_attempts_exhausted_action`, un rifiuto per impostazione predefinita, a meno che un tentativo precedente non abbia già raggiunto un verdetto, come una mancata corrispondenza del nome. In tal caso, quel verdetto rimane valido.

Questa pagina illustra le altre modalità di verifica offerte da ciascun paese, quando la persona visualizza **Continua senza la tua banca**, come viene deciso ciascun caso e come leggerlo nel risultato.

## Modalità di verifica

| Modalità di verifica | `method` | Dove è disponibile |
| - | - | - |
| Accesso bancario | `open_banking` | Dove un instradamento copre il paese. |
| Controllo del conto | `account_lookup` | Dove un instradamento copre il paese. |
| Caricamento estratto conto | `statement` | Qualsiasi paese, quando il passaggio lo abilita (`bank_statement_enabled`). |
| Micro-depositi | `microdeposits` | Solo dove un instradamento invia i depositi, dopo un accesso bancario o un controllo del conto tariffato nella stessa sessione (`bank_microdeposits_enabled`). |
| Continua senza la tua banca | `none` | Sempre. Non può essere disattivato. |

La persona inizia dall'accesso bancario o dal controllo del conto, nell'ordine impostato per il suo paese: consulta [Scegliere i metodi per paese](https://docs.didit.me/it/core-technology/bank-verification/verification-methods.md#scegliere-i-metodi-per-paese). Il caricamento dell'estratto conto e i micro-depositi sono opzioni di fallback successive a queste due. **Continua senza la tua banca** arriva per ultimo.

Una modalità non utilizzabile da un paese non viene mai proposta alla persona che si trova lì. Nella console, **Paesi e metodi** la mostra come **Non disponibile** per quel paese.

### Un paese non coperto da alcun instradamento bancario

Un paese in cui non è disponibile alcun instradamento né per l'accesso bancario né per il controllo del conto resta nel passaggio. I suoi utenti caricano un estratto conto, se il passaggio ne prevede uno, oppure proseguono senza banca.

Un salvataggio mantiene tale paese se omette `methods` o lo imposta su `null`. Il suo `methods` non può elencare alcun metodo, poiché nessun instradamento ne serve uno in quel paese: l'operazione verrebbe rifiutata al momento del salvataggio, ad esempio con `Account check is not available in VNM.` Anche un elenco vuoto viene rifiutato, come in qualsiasi paese abilitato, con `Choose a method: bank sign-in, account check, or both.` Se il tuo contratto definisce prezzi personalizzati e non include il caricamento dell'estratto conto, un salvataggio che ne offre uno senza un tentativo bancario precedente rifiuterà a sua volta tale paese.

```json theme={null}
{
  "bank_statement_enabled": true,
  "bank_countries": {
    "GBR": { "enabled": true, "institutions": "all" },
    "VNM": { "enabled": true, "institutions": "all" }
  }
}
```

In questo caso il Vietnam rappresenta un paese non coperto da alcun instradamento bancario. Non definisce alcun `methods`, quindi il salvataggio lo accetta, e i suoi utenti visualizzano il caricamento dell'estratto conto e **Continua senza la tua banca**.

### Caricamento dell'estratto conto

Il caricamento dell'estratto conto richiede un estratto conto bancario degli ultimi 3 mesi che riporti il nome della persona, la sua banca e il numero di conto. Didit lo legge, verifica che non sia stato modificato e confronta il nome del titolare nello stesso modo in cui confronta quello fornito dalla banca.

Con `bank_statement_enabled` attivo, il passaggio lo offre in due casi:

* **Dopo un tentativo tariffato:** una volta addebitato un tentativo di accesso bancario o di controllo del conto nella stessa sessione, il caricamento dell'estratto conto funge da fallback, incluso senza costi aggiuntivi.
* **Senza alcun tentativo bancario precedente:** in qualsiasi paese, compresi quelli non coperti da alcun instradamento bancario. Ciò richiede `bank_statement_standalone_enabled`, attivo per impostazione predefinita. Disattivalo per offrire il caricamento dell'estratto conto solo dopo un tentativo tariffato.

Il caricamento dell'estratto conto e i micro-depositi consumano ciascuno uno dei `bank_max_attempts` del passaggio, gli stessi tentativi utilizzati dall'accesso bancario. Una volta esauriti tutti, nessuno dei due viene più offerto, nemmeno dopo un tentativo tariffato. Il controllo del conto ha un proprio parametro `bank_account_check_max_attempts`, quindi, dove rappresenta l'unico metodo, una persona che ha esaurito tutti i controlli del conto può comunque caricare un estratto conto, se il passaggio lo prevede. Quando un tentativo fallito esaurisce l'ultimo tentativo di ogni modalità ancora a disposizione dell'utente, compreso il caricamento dell'estratto conto, il passaggio termina autonomamente: alla persona non viene chiesto di continuare e il risultato non registra alcuna prosecuzione. La sessione segue `bank_attempts_exhausted_action`, a meno che un tentativo precedente non abbia già raggiunto un verdetto, come una mancata corrispondenza del nome, che rimane valido. Per lasciare spazio a un fallback dopo un accesso bancario fallito, imposta `bank_max_attempts` su `2` o più.

## Quando la persona vede Continua senza la propria banca

`bank_continue_without_bank` determina quando il passaggio mostra **Continua senza la propria banca**:

| Valore | Il passaggio lo mostra |
| - | - |
| `when_needed` (il valore predefinito) | Quando nessun metodo funziona per il paese o la banca della persona, quando la sua banca non è raggiungibile in quel momento e nessun altro metodo potrebbe verificare la persona, oppure quando dichiara di non avere l'online banking o che la propria banca non è presente nell'elenco. |
| `from_start` | Anche nella prima schermata. |

Nessuno dei due valori disattiva l'opzione: la persona può sempre continuare. Nella console, impostalo nel passaggio Bank Verification sotto **Quando la persona non riesce a verificare**, come **Mostra l'opzione Continua senza banca**: **Quando nient'altro funziona** o **Dall'inizio**.

```json theme={null}
{
  "bank_continue_without_bank": "when_needed"
}
```

### Cosa vede la persona

* **Nessun percorso nel suo paese:** ad esempio "Non possiamo ancora connetterci alle banche in Vietnam", con il caricamento dell'estratto conto sotto **Altri modi per verificare** e **Continua senza la propria banca**.
* **Una banca che non può essere utilizzata qui:** "Questa banca non può essere utilizzata qui". La persona può inserire i dati del proprio conto dove il paese offre il controllo del conto, caricare un estratto conto, scegliere una banca diversa o continuare senza la propria banca.
* **Nessun online banking o una banca non presente nell'elenco:** "Verifica il tuo conto in un altro modo", con le modalità offerte dal suo paese e **Continua senza la propria banca**.
* **Una banca che non può essere raggiunta in questo momento:** la persona può riprovare. La schermata offre anche **Continua senza la propria banca** nel momento in cui l'altro metodo, l'accesso bancario o il controllo del conto, non può essere d'aiuto: il paese non lo offre, non sono rimasti tentativi disponibili o neanche l'ultimo tentativo è riuscito a raggiungere la banca.
* **Dopo aver continuato:** "Grazie, puoi continuare". Alla persona non viene mai mostrato un esito negativo e passa al passaggio successivo del tuo workflow.

## Scegli l'esito

Quando la persona continua senza banca, Didit ne individua il motivo in base a quanto accaduto nel passaggio. Non ricava mai il motivo dal dispositivo della persona. Ciascun motivo, registrato come `continuation.reason`, segue la propria impostazione dell'esito:

* `no_route`: nel suo paese non è disponibile alcun percorso di accesso bancario o di controllo del conto. Determinato da `bank_unsupported_action`, `REVIEW` per impostazione predefinita, con codice motivo `NOT_COVERED`.
* `institution_unsupported`: la banca selezionata non può essere utilizzata in questo passaggio. Determinato da `bank_unsupported_action`, `REVIEW` per impostazione predefinita, con codice motivo `NOT_COVERED`.
* `attempts_exhausted`: tutti i tentativi erano già stati esauriti, e nessuno era ancora in corso, quando la persona continua. Determinato da `bank_attempts_exhausted_action`, `DECLINE` per impostazione predefinita.
* `person_choice`: era disponibile una modalità di verifica e la persona ha scelto di continuare. Questo include una banca che non è stato possibile raggiungere in quel momento: la banca è coperta, quindi il motivo è la scelta della persona stessa. Determinato da `bank_skipped_action`, `REVIEW` per impostazione predefinita, con codice motivo `SKIPPED`.

`bank_skipped_action` e `bank_attempts_exhausted_action` accettano `REVIEW` o `DECLINE`. `bank_unsupported_action` accetta anche `NO_ACTION`, che approva il passaggio continuando comunque a registrare `NOT_COVERED`.

Nella console, queste sono le righe **Banca o paese non coperti**, **Continuato senza banca** e **Tentativi esauriti** della scheda **Esiti** del passaggio.

```json theme={null}
{
  "bank_continue_without_bank": "when_needed",
  "bank_unsupported_action": "REVIEW",
  "bank_skipped_action": "REVIEW",
  "bank_attempts_exhausted_action": "DECLINE"
}
```

> [!NOTE]
>
> Il proseguimento non sostituisce mai il verdetto già raggiunto da un tentativo. Se un tentativo è già stato valutato, ad esempio se la banca o un estratto conto ha indicato un titolare non corrispondente e la persona aveva ancora tentativi a disposizione, oppure una corrispondenza stretta che la persona non ha confermato, il passaggio mantiene tale verdetto e i relativi codici motivo. In tal caso non si applica alcuna impostazione di esito dell'elenco sopra indicato e non viene aggiunto alcun `NOT_COVERED` o `SKIPPED`. Il risultato registra comunque che la persona ha continuato: consulta [Leggilo nel risultato](#leggilo-nel-risultato).

## Leggilo nel risultato

### Decisione e webhook

L'elemento del passaggio in `bank_verifications[]`, nella [decisione della sessione](https://docs.didit.me/it/sessions-api/retrieve-session.md#verifica-bancaria) e nell'oggetto `decision` dei [webhook `status.updated`](https://docs.didit.me/it/integration/webhooks#array-plurali-v3-importante), indica se la persona ha continuato senza una banca:

* `continued_without_bank` è `true`: la persona ha lasciato il passaggio con **Continua senza la tua banca**.
* `method` è `none` quando nessun tentativo è stato valutato prima che la persona continuasse. Dopo un tentativo valutato, ad esempio quando l'intestatario non corrisponde, `method` rimane il metodo di quel tentativo e il relativo verdetto resta valido.
* `continuation` indica come la persona ha continuato:
  * `reason`: `no_route`, `institution_unsupported`, `attempts_exhausted` o `person_choice`.
  * `country`: il paese in cui la persona stava effettuando la verifica, ISO 3166-1 alpha-3, oppure `null` se ha continuato prima di selezionarne uno.
  * `offered`: gli altri metodi offerti per verificare in quel paese, nell'ordine in cui sono stati proposti: `statement`, poi `microdeposits`. Vuoto se non ne è stato offerto nessuno.
  * `institution_id` e `institution_name`: per `institution_unsupported`, la banca che la persona non ha potuto utilizzare: la banca selezionata o quella su cui si è concluso l'ultimo tentativo. Didit ricava entrambi dal proprio elenco di banche, mai dal dispositivo della persona; pertanto, una banca non presente in tale elenco lascia entrambi i valori a `null`. Entrambi sono `null` per qualsiasi altro motivo.
  * `continued_at`: quando la persona ha continuato.
* `reason_codes` contiene `NOT_COVERED` o `SKIPPED`, come descritto in [Scegli l'esito](#scegli-l’esito), quando la continuazione ha determinato la decisione del passaggio. Dopo un tentativo valutato, mantiene i codici di motivo di tale tentativo.
* `not_covered` è `true` per `no_route` e `institution_unsupported`.

```json theme={null}
{
  "bank_verifications": [
    {
      "node_id": "feature_bank_verification",
      "status": "In Review",
      "method": "none",
      "continued_without_bank": true,
      "continuation": {
        "reason": "institution_unsupported",
        "country": "ESP",
        "offered": ["statement"],
        "institution_id": "example_bank_es",
        "institution_name": "Example Bank",
        "continued_at": "2026-11-03T08:15:41.512870+00:00"
      },
      "not_covered": true,
      "ownership": null,
      "reason_codes": ["NOT_COVERED"]
    }
  ]
}
```

L'esempio mostra solo i campi trattati in questa pagina. Ciascun campo è presente nello schema `BankVerificationResult` della [documentazione di riferimento delle API](https://docs.didit.me/it/sessions-api/retrieve-session.md).

Quando il tuo workflow limita i dati restituiti, `continued_without_bank` e `continuation.reason` vengono comunque restituiti, consentendoti di distinguere `no_route` da `institution_unsupported`, che condividono `NOT_COVERED`. Tutte le altre chiavi di `continuation` sono quindi `null`: il paese, la banca, cosa è stato offerto e quando. `continuation` stesso è `null` quando la persona non ha continuato. Anche `method` non viene restituito in questo caso; pertanto, leggi `continued_without_bank`, e non `method`, per sapere se la persona ha continuato.

### Regole del workflow

I rami e le regole di stato personalizzate possono leggere:

* `bank.continued_without_bank`: `true` o `false`.
* `bank.continue_reason`: `no_route`, `institution_unsupported`, `attempts_exhausted` o `person_choice`.
* `bank.method`: `none` quando la persona ha continuato senza una banca prima che venisse valutato qualsiasi tentativo. Dopo un tentativo valutato, il metodo di quel tentativo.

### Report di sessione

Quando la persona ha continuato senza una banca prima che venisse valutato qualsiasi tentativo, la riga **Metodo di verifica** del report PDF della sessione riporta **Continuato senza banca**. Dopo un tentativo valutato, riporta il metodo di quel tentativo.

## Prezzi

* **Continua senza la tua banca** non viene mai fatturato. I tentativi effettuati dalla persona prima di continuare vengono fatturati come di consueto.
* **Il caricamento di un estratto conto senza un precedente tentativo bancario addebitato** costa \$0.20 per ciascun estratto conto letto e valutato da Didit. Viene fatturato su una voce di utilizzo dedicata, **Bank verification - statement upload** (`bank_statement_upload`), e ad esso si applica la tariffa contrattuale o il prezzo speciale come per qualsiasi componente aggiuntivo. Se il tuo contratto stabilisce prezzi personalizzati e non lo include, il passaggio non lo offrirà.
* **Il caricamento di un estratto conto o i micro-depositi successivi a un accesso bancario o a una verifica del conto addebitati** nella stessa sessione sono inclusi senza costi aggiuntivi.

## Nodi salvati prima di Continua senza la tua banca

`bank_allow_skip` è stato ritirato. Un nodo salvato con questo parametro viene ora eseguito con il valore corrispondente:

| `bank_allow_skip` | Il nodo viene eseguito con |
| - | - |
| `true` | `bank_continue_without_bank: "from_start"` |
| `false` o non impostato | `bank_continue_without_bank: "when_needed"` |

Un nodo che non consentiva il salto lasciava in precedenza la persona senza alcuna via d'uscita quando nessuna opzione funzionava. Ora mostra **Continua senza la tua banca** in tali casi, e `bank_unsupported_action`, `bank_attempts_exhausted_action` o `bank_skipped_action` decide la sessione.

Per una versione, un salvataggio che invia `bank_allow_skip` ma non `bank_continue_without_bank` imposta comunque la modalità in base a esso. Ogni salvataggio riscrive `bank_allow_skip`: `true` per `from_start`, `false` per `when_needed`. Utilizza `bank_continue_without_bank` nelle nuove integrazioni.

## Esecuzione di test in sandbox

Un'applicazione in sandbox non comporta alcun addebito, e il caricamento dell'estratto conto e i micro-depositi non richiedono un tentativo bancario precedente. Imposta `bank_continue_without_bank` su `from_start` per visualizzare **Continua senza la tua banca** nella prima schermata, e selezionalo per testare `bank_skipped_action`. Consulta [Test in sandbox](https://docs.didit.me/it/integration/sandbox-testing.md) per informazioni sul funzionamento generale delle applicazioni in sandbox.

## Correlati

* [Metodi di verifica bancaria](https://docs.didit.me/it/core-technology/bank-verification/verification-methods.md): accesso bancario e verifica del conto, per paese.
* [Verifica del conto](https://docs.didit.me/it/core-technology/bank-verification/account-check.md): formati dei conti, risultati e valori sandbox.
* [Chiavi di configurazione della verifica bancaria](https://docs.didit.me/it/management-api/workflows/feature-configs.md#verifica-del-conto-bancario): tutte le chiavi del passaggio.


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