> ## 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. # Metodi di verifica bancaria: accesso o verifica del conto > Didit offre verifica bancaria tramite accesso o controllo del conto: scopri cosa provano, cosa restituiscono e come ordinarli per paese. Bank Verification conferma che un conto bancario appartiene alla persona o all'azienda verificata da un passaggio precedente del tuo workflow. Si tratta di un unico passaggio del workflow con due metodi: la persona accede alla propria banca oppure inserisce i dati del proprio conto e la banca conferma l'intestatario del conto. Puoi scegliere quali metodi offrire in ciascun paese e quale presentare per primo. > [!NOTE] > > In produzione, l'accesso bancario è operativo in Nigeria e Nuova Zelanda, mentre la verifica del conto è operativa in Nigeria, Ghana e Kenya. > Con il tempo verranno aggiunti altri paesi, e i [Prezzi di Bank Verification](https://docs.didit.me/it/getting-started/bank-verification-pricing.md) mostrano sempre cosa offre ciascun paese ad oggi. > [!NOTE] > > Bank Verification confronta l'intestatario del conto con l'identità stabilita da **un altro passaggio**, quindi di per sé non costituisce una prova di identità. Inserisci Verifica dell'identità, Validazione su database, un questionario o `expected_details` prima di questo passaggio. La persona non digita mai il nome controllato: Didit confronta sempre il nome già verificato dalla sessione. ## I due metodi | | Accesso bancario | Verifica del conto | | - | - | - | | Valore del metodo | `open_banking` | `account_lookup` | | Cosa fa la persona | Accede alla propria banca e condivide il conto. | Digita i dati del conto: IBAN, sort code e numero di conto, CLABE e così via. Nessun accesso. | | Cosa dimostra | Il controllo del conto, oltre all'intestatario restituito dalla banca. | Il nome dell'intestatario registrato presso la banca per quel conto corrisponde al nome verificato. | | Dati aggiunti | Saldi, transazioni e reddito, se richiesti dal passaggio. | Nessuno: solo la titolarità. | | Uso tipico | Onboarding, prestiti, valutazione di sostenibilità creditizia, clienti ad alto rischio. | Pagamenti e prelievi, onboarding a basso attrito, paesi senza accesso bancario. | Entrambi i metodi forniscono lo stesso tipo di risultato: se l'intestatario corrisponde, l'intestatario restituito dalla banca e il conto mascherato. I metodi variano in base al paese, e un paese può offrirne uno, entrambi o entrambi in qualsiasi ordine. Consulta la [verifica del conto](https://docs.didit.me/it/core-technology/bank-verification/account-check.md) per i formati di conto, i risultati e i valori di sandbox. Il caricamento dell'estratto conto e i micro-depositi rimangono soluzioni di fallback dopo i due metodi (`bank_statement_enabled`, `bank_microdeposits_enabled`), e la persona può sempre continuare senza utilizzare una banca. I micro-depositi vengono offerti solo dopo un accesso bancario a pagamento o una verifica del conto a pagamento nella stessa sessione, senza costi aggiuntivi. Anche il caricamento dell'estratto conto è incluso dopo uno di essi, e può essere proposto anche senza alcun tentativo bancario preliminare, in qualsiasi paese. Consulta [Quando la persona non riesce a verificare la propria banca](https://docs.didit.me/it/core-technology/bank-verification/fallbacks.md). ## Cosa vede la persona In ciascun paese, la persona inizia con il primo metodo offerto dal paese. Il secondo funge da backup: * **Prima l'accesso bancario:** si apre il selettore della banca. L'ultima riga, **Inserisci i dati del tuo conto**, avvia la verifica del conto. Se l'accesso bancario non riesce, la stessa riga compare di nuovo sotto **Altri modi per verificare**. * **Prima la verifica del conto:** si apre il modulo del conto, con sotto il link **Accedi invece alla tua banca**. * **Un solo metodo:** la persona vede solo quello. Nei casi in cui un paese offre la verifica del conto, questa funge anche da backup per una banca che l'accesso bancario non riesce a raggiungere al momento, perché degradata o non disponibile: la persona passa al modulo del conto prima che venga richiesto qualsiasi consenso, a condizione che abbia ancora verifiche del conto a disposizione. Un metodo non supportato da alcuna route in un paese viene escluso in quel paese, quindi la persona non vede mai un metodo che non può essere eseguito. Un paese non supportato da alcuna route offre solo le proprie soluzioni di fallback e **Continua senza la tua banca**. ## Scegliere i metodi per paese ### L'ordine del passaggio `bank_method_order` imposta quali metodi vengono offerti dal passaggio e in quale ordine, per ogni paese che non ne definisce uno proprio. Elenca `open_banking`, `account_lookup` o entrambi, specificando per primo quello iniziale. ```json theme={null} { "bank_method_order": ["open_banking", "account_lookup"] } ``` Un salvataggio che non invia `bank_method_order` riceve `["open_banking", "account_lookup"]`: prima l'accesso bancario, con la verifica del conto come backup. Un elenco vuoto viene rifiutato con `Choose a method: bank sign-in, account check, or both.` L'ordine del passaggio è un valore predefinito. In un paese in cui nessuna route serve uno dei suoi metodi, quel metodo viene escluso e il paese offre i rimanenti. Un paese servito da una route, ma che l'ordine lascia senza alcun metodo, viene rifiutato al salvataggio, ad esempio `Choose a method: bank sign-in, account check, or both. ARE offers account check.` Un paese non servito da alcuna route viene mantenuto, proponendo solo le sue soluzioni di fallback: vedi [Un paese non servito da alcuna route bancaria](https://docs.didit.me/it/core-technology/bank-verification/fallbacks.md#un-paese-non-coperto-da-alcun-instradamento-bancario). ### L'ordine specifico di un paese `methods` su un paese in `bank_countries` sovrascrive l'ordine del passaggio per quel paese. La persona inizia con il primo metodo e le viene offerto il secondo come backup. ```json theme={null} { "bank_method_order": ["open_banking", "account_lookup"], "bank_countries": { "GBR": { "enabled": true, "institutions": "all" }, "NOR": { "enabled": true, "institutions": "all", "methods": ["open_banking"] }, "MEX": { "enabled": true, "institutions": "all", "methods": ["account_lookup", "open_banking"] } } } ``` Qui il Regno Unito segue l'ordine del passaggio, la Norvegia offre solo l'accesso bancario e il Messico inizia con la verifica del conto con l'accesso bancario come backup. Un paese con `methods` impostato su `null`, o senza la chiave, segue l'ordine del passaggio. Il salvataggio viene rifiutato, sotto `bank_countries.`, quando un paese abilitato: * imposta `methods` su un elenco vuoto, anche in un paese non servito da alcuna route, oppure * indica un metodo non supportato da alcuna route in quel paese, ad esempio `Account check is not available in NOR.` Un paese non servito da alcuna route omette `methods`, o lo imposta su `null`, e offre solo le proprie soluzioni di fallback: vedi [Un paese non servito da alcuna route bancaria](https://docs.didit.me/it/core-technology/bank-verification/fallbacks.md#un-paese-non-coperto-da-alcun-instradamento-bancario). ### Nella console Nel passaggio Bank verification, **Paesi e metodi** elenca ciascun paese indicando cosa offrono l'accesso bancario e la verifica del conto in tale paese, e quale metodo viene presentato per primo. I relativi preset compilano tutti i paesi contemporaneamente: | Preset | Ordine | | - | - | | Accesso bancario, verifica del conto come backup (predefinito) | `["open_banking", "account_lookup"]` | | Solo accesso bancario | `["open_banking"]` | | Solo verifica del conto | `["account_lookup"]` | | Verifica del conto, accesso bancario come backup | `["account_lookup", "open_banking"]` | Un preset non lascia mai un paese senza metodi: se un paese dispone di uno solo dei due metodi, questo rimane attivo. ## I dati finanziari richiedono l'accesso alla banca Solo l'accesso alla banca legge saldi, transazioni e reddito. Quando il passaggio li richiede in `bank_scopes` e un paese offre il controllo del conto, una persona che effettua la verifica tramite controllo del conto passa senza tali dati. Il passaggio non fallisce: il risultato elenca ciò che non è stato raccolto in `financial_data.not_collected`. ```json theme={null} "financial_data": { "balances": null, "transactions": null, "income": null, "categorization": null, "not_collected": ["balances", "transactions"] } ``` `not_collected` è un elenco vuoto ogni volta che il metodo ha raccolto tutto ciò che il passaggio richiedeva. Per richiedere i dati, offri solo l'accesso alla banca nei paesi in cui ne hai bisogno. ## Impostazioni del controllo del conto Queste chiavi configurano esclusivamente il controllo del conto. L'accesso alla banca mantiene le proprie impostazioni. | Campo di configurazione | Effetto | | - | - | | `bank_account_check_accept_close_match` | Attivo (predefinito): un nome a cui la banca attribuisce un punteggio compreso tra `bank_partial_match_floor` e `bank_name_match_threshold` è considerato una corrispondenza ravvicinata. La persona conferma il nome registrato presso la banca quando `bank_suggest_holder_name` è attivo, e `bank_partial_match_action` decide l'esito. Disattivo: tale corrispondenza ravvicinata è considerata una mancata corrispondenza (`OWNER_NAME_MISMATCH`), decisa da `bank_no_match_action`, e consuma il tentativo. | | `bank_account_check_max_attempts` | Numero di controlli del conto concessi alla persona, da `1` a `5`, `3` se non impostato: quante volte è possibile inserire i dati del conto per un controllo a cui la banca risponde. Un conto rifiutato per come è stato digitato, o un controllo a cui la banca non ha potuto rispondere, non consuma alcun tentativo. | I tentativi vengono conteggiati per metodo. `bank_max_attempts` conteggia i tentativi di accesso alla banca, e anche un micro-deposito o il caricamento di un estratto conto ne consuma uno. `bank_account_check_max_attempts` conteggia i controlli del conto. Il passaggio termina su `bank_attempts_exhausted_action` una volta che tutte le modalità di verifica ancora offerte alla persona, compreso il caricamento dell'estratto conto, hanno esaurito i relativi tentativi senza una connessione riuscita: vedi [Il caricamento dell'estratto conto](https://docs.didit.me/it/core-technology/bank-verification/fallbacks.md#caricamento-dell’estratto-conto). ## Leggi il metodo nel risultato ### Decisione e webhook Ciascun passaggio di Bank Verification è un elemento di `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). Il relativo `method` indica come è stato verificato il conto: | `method` | Mostrato come | | - | - | | `open_banking` | Accesso alla banca | | `account_lookup` | Controllo del conto | | `microdeposits` | Micro-depositi | | `statement` | Caricamento dell'estratto conto | | `none` | Proseguito senza banca | `method` è `null` fino a quando un conto non è stato valutato, e `none` quando la persona ha continuato senza una banca prima che qualsiasi tentativo fosse valutato: vedi [Leggilo nel risultato](https://docs.didit.me/it/core-technology/bank-verification/fallbacks.md#leggilo-nel-risultato). Leggi `method`, e non `ownership.method`, per distinguere i metodi: `ownership.method` è il confronto del nome che ha generato il punteggio, come `exact` o `fuzzy`. ```json theme={null} { "bank_verifications": [ { "node_id": "feature_bank_verification", "status": "Approved", "method": "account_lookup", "ownership": { "result": "match", "method": "exact" }, "financial_data": { "balances": null, "transactions": null, "income": null, "categorization": null, "not_collected": [] } } ] } ``` L'esempio mostra solo i campi trattati in questa pagina. Tutti i campi sono presenti nello schema `SessionDecision` del [riferimento API](https://docs.didit.me/it/sessions-api/retrieve-session.md). ### Regole del workflow I rami e le regole di stato personalizzate leggono lo stesso valore di `bank.method`, indicato come **Bank Verification Method** nel costruttore di regole, con i valori **Accesso alla banca**, **Controllo del conto**, **Micro-depositi**, **Caricamento dell'estratto conto** e **Proseguito senza una banca**. Una regola confronta il valore del metodo, ad esempio un ramo dopo un passaggio di Screening AML che invia in revisione un controllo del conto con un punteggio di rischio elevato: ```json theme={null} { "id": "account_check_high_risk", "rules": [ { "field": "bank.method", "operator": "equals", "value": "account_lookup" }, { "field": "aml.risk_score", "operator": "greater_than", "value": 70 } ], "logic": "and", "goto": "status_in_review" } ``` ### Report della sessione Il report PDF della sessione indica il metodo nella riga **Metodo di verifica**. ## Nodi salvati prima dei metodi `bank_open_banking_enabled` e `bank_account_lookup_enabled` sono stati ritirati. Un nodo salvato prima dell'esistenza di `bank_method_order` viene ora eseguito con l'ordine stabilito dai suoi due interruttori: | `bank_open_banking_enabled` | `bank_account_lookup_enabled` | Il nodo viene eseguito con | | - | - | - | | Attivo o non impostato | Disattivo o non impostato | `["open_banking"]` | | Attivo o non impostato | Attivo | `["open_banking", "account_lookup"]` | | Disattivo | Attivo | `["account_lookup"]` | Dove il controllo del conto era attivo insieme all'accesso alla banca, la persona lo vede ora come alternativa nel selettore della banca, **Inserisci i dati del tuo conto**, non solo quando la sua banca non è disponibile. Un nodo con entrambi gli interruttori disattivati, che offriva solo micro-depositi o il caricamento dell'estratto conto, viene lasciato così com'è; un successivo salvataggio deve attivare almeno uno dei due metodi. Per una versione, un salvataggio che non invia `bank_method_order` ma invia uno dei due interruttori imposta comunque l'ordine a partire dagli interruttori. Ogni salvataggio riscrive entrambi gli interruttori, indicando se un qualsiasi paese offre l'accesso alla banca e se un qualsiasi paese offre il controllo del conto. Utilizza `bank_method_order` e `bank_countries..methods` nelle nuove integrazioni. ## Prezzi Ciascun metodo viene fatturato al proprio prezzo, per paese. Vedi i [prezzi di Bank Verification](https://docs.didit.me/it/getting-started/bank-verification-pricing.md) per i prezzi di ogni paese. * L'**Accesso alla banca** ha un proprio prezzo, e i componenti aggiuntivi per saldi e transazioni aggiungono ciascuno il proprio costo. * Il **controllo del conto** viene fatturato una volta per ogni controllo a cui la banca risponde: una corrispondenza, una corrispondenza ravvicinata, una mancata corrispondenza, un conto che la banca non ha potuto verificare e un conto che la banca non ha trovato. Un conto rifiutato per come è stato digitato non viene mai fatturato. Nei paesi in cui sono offerti entrambi i metodi, una sessione può costare l'uno o l'altro prezzo, a seconda del metodo utilizzato dalla persona. Il caricamento dell'estratto conto e i micro-depositi sono inclusi senza costi aggiuntivi dopo un tentativo a pagamento. Un caricamento dell'estratto conto senza alcun tentativo bancario precedente costa \$0.20, e proseguire senza una banca non viene mai fatturato: vedi [Prezzi](https://docs.didit.me/it/core-technology/bank-verification/fallbacks.md#prezzi). L'[API del controllo del conto](https://docs.didit.me/it/standalone-apis/bank-account-check.md) esegue lo stesso controllo dal tuo backend, senza sessione, allo stesso prezzo del controllo del conto. ## Test in sandbox Un'applicazione sandbox supporta entrambi i metodi in ogni paese, nell'ordine impostato dal passaggio, e non addebita nulla. Con l'ordine predefinito, la persona inizia con l'accesso alla banca e sceglie **Inserisci i dati del tuo conto** per eseguire il controllo del conto. Per iniziare con il controllo del conto, imposta `bank_method_order` su `["account_lookup", "open_banking"]`. Gli ultimi quattro caratteri del conto determinano la risposta del controllo del conto: vedi [Testa in sandbox](https://docs.didit.me/it/core-technology/bank-verification/account-check.md#test-in-sandbox). ## Correlati * [Account check](https://docs.didit.me/it/core-technology/bank-verification/account-check.md): formati dei conti, risultati e valori sandbox. * [Quando la persona non può verificare la propria banca](https://docs.didit.me/it/core-technology/bank-verification/fallbacks.md): alternative, Continua senza la tua banca e i relativi esiti. * [API di Account check](https://docs.didit.me/it/standalone-apis/bank-account-check.md): verifica un conto di accredito dal tuo backend, senza sessione. * [Chiavi di configurazione di Bank Verification](https://docs.didit.me/it/management-api/workflows/feature-configs.md#verifica-del-conto-bancario): tutte le chiavi del passaggio. * [Test in sandbox](https://docs.didit.me/it/integration/sandbox-testing.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.