Vai al contenuto principale
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

La persona inizia dall’accesso bancario o dal controllo del conto, nell’ordine impostato per il suo paese: consulta 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.
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: 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.

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

Decisione e webhook

L’elemento del passaggio in bank_verifications[], nella decisione della sessione e nell’oggetto decision dei webhook status.updated, 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, 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.
L’esempio mostra solo i campi trattati in questa pagina. Ciascun campo è presente nello schema BankVerificationResult della documentazione di riferimento delle API. 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: 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 per informazioni sul funzionamento generale delle applicazioni in sandbox.

Correlati

Ultima modifica il 7 novembre 2026