Metodi di verifica bancaria: accesso o verifica del conto

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.

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 mostrano sempre cosa offre ciascun paese ad oggi.

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

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.

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

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.

{
  "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.<ISO3>, 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.

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.

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

Leggi il metodo nel risultato

Decisione e webhook

Ciascun passaggio di Bank Verification è un elemento di bank_verifications[] nella decisione della sessione e nell’oggetto decision dei webhook status.updated. 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. 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.

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

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:

{
  "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.<ISO3>.methods nelle nuove integrazioni.

Prezzi

Ciascun metodo viene fatturato al proprio prezzo, per paese. Vedi i prezzi di Bank Verification 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. L’API del controllo del conto 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.

Correlati

Account check: formati dei conti, risultati e valori sandbox.
Quando la persona non può verificare la propria banca: alternative, Continua senza la tua banca e i relativi esiti.
API di Account check: verifica un conto di accredito dal tuo backend, senza sessione.
Chiavi di configurazione di Bank Verification: tutte le chiavi del passaggio.
Test in sandbox.

Autenticazione

Verifica

Monitoraggio

Piattaforma

Metodi di verifica bancaria: accesso o verifica del conto

I due metodi

Cosa vede la persona

Scegliere i metodi per paese

L’ordine del passaggio

L’ordine specifico di un paese

Nella console

I dati finanziari richiedono l’accesso alla banca

Impostazioni del controllo del conto

Leggi il metodo nel risultato

Decisione e webhook

Regole del workflow

Report della sessione

Nodi salvati prima dei metodi

Prezzi

Test in sandbox

Correlati

​I due metodi

​Cosa vede la persona

​Scegliere i metodi per paese

​L’ordine del passaggio

​L’ordine specifico di un paese

​Nella console

​I dati finanziari richiedono l’accesso alla banca

​Impostazioni del controllo del conto

​Leggi il metodo nel risultato

​Decisione e webhook

​Regole del workflow

​Report della sessione

​Nodi salvati prima dei metodi

​Prezzi

​Test in sandbox

​Correlati

I due metodi

Cosa vede la persona

Scegliere i metodi per paese

L’ordine del passaggio

L’ordine specifico di un paese

Nella console

I dati finanziari richiedono l’accesso alla banca

Impostazioni del controllo del conto

Leggi il metodo nel risultato

Decisione e webhook

Regole del workflow

Report della sessione

Nodi salvati prima dei metodi

Prezzi

Test in sandbox

Correlati