Saltar al contingut principal
Bank Verification confirma que un compte bancari pertany a la persona o empresa que ha estat verificada en un pas anterior del teu flux de treball. És un pas del flux de treball amb dos mètodes: la persona inicia sessió al seu banc, o bé escriu les dades del seu compte i el banc confirma el nom que hi consta. Tu tries quins mètodes ofereix cada país i quin va primer.
En producció, l’inici de sessió al banc funciona a Nigèria i Nova Zelanda, i la comprovació del compte funciona a Nigèria, Ghana i Kenya. Amb el temps s’obriran més països, i els preus de Bank Verification sempre mostren què ofereix cada país actualment.
Bank Verification compara el titular del compte amb una identitat que ha establert un altre pas, de manera que no és una prova d’identitat per si sola. Col·loca la Verificació d’identitat, la Validació en bases de dades, un qüestionari o expected_details abans d’aquest pas. La persona mai escriu el nom que es comprova: Didit sempre compara el nom que la sessió ja ha verificat.

​
Els dos mètodes

Tots dos mètodes ofereixen el mateix tipus de resultat: si el titular coincideix, el titular retornat pel banc i el compte emmascarat. Els mètodes varien segons el país, i un país pot oferir-ne un, tots dos, o tots dos en qualsevol ordre. Consulta la comprovació del compte per conèixer els formats de compte, els resultats i els valors de sandbox. La càrrega d’un extracte i els microdipòsits continuen com a alternatives després dels dos mètodes (bank_statement_enabled, bank_microdeposits_enabled), i la persona sempre pot continuar sense banc. Els microdipòsits només s’ofereixen després d’un inici de sessió al banc o d’una comprovació del compte facturada en la mateixa sessió, sense cap cost addicional. La càrrega d’un extracte també s’inclou després d’un d’aquests intents, i també es pot oferir sense cap intent previ amb el banc, a qualsevol país. Consulta Quan la persona no pot verificar el seu banc.

​
El que veu la persona

A cada país, la persona comença pel primer mètode que el país ofereix. El segon funciona com a alternativa:
  • Inici de sessió al banc primer: s’obre el selector de bancs. La seva última fila, Introdueix les dades del teu compte, inicia la comprovació del compte. Si l’inici de sessió al banc falla, la mateixa fila torna a aparèixer a Altres maneres de verificar.
  • Comprovació del compte primer: s’obre el formulari del compte, amb l’enllaç Inicia sessió al teu banc en el seu lloc a sota.
  • Un sol mètode: la persona només veu aquest mètode.
Quan un país ofereix la comprovació del compte, aquesta també serveix de suport per a un banc al qual l’inici de sessió al banc no pot accedir en aquell moment, perquè el banc funciona amb problemes o està caigut: la persona passa al formulari del compte abans que se li demani cap consentiment, sempre que li quedin comprovacions de compte disponibles. Si cap ruta no dona servei a un mètode en un país determinat, aquest mètode s’omet, de manera que la persona mai no veurà un mètode que no es pugui executar. Un país al qual directament cap ruta no dona servei només ofereix les seves alternatives i Continua sense el teu banc.

​
Tria els mètodes per país

​
L’ordre del pas

bank_method_order defineix quins mètodes ofereix el pas, i en quin ordre, per a tots els països que no en configuren cap de propi. Llista open_banking, account_lookup o tots dos, amb el primer en primera posició.
Si es desa sense enviar cap bank_method_order, s’estableix ["open_banking", "account_lookup"]: primer l’inici de sessió al banc, amb la comprovació del compte com a alternativa. Si s’envia una llista buida, es rebutja amb Choose a method: bank sign-in, account check, or both. L’ordre del pas és un valor per defecte. En un país on cap ruta no dona servei a un dels seus mètodes, aquest mètode s’omet, i el país ofereix la resta. Si una ruta dona servei a un país però l’ordre el deixa sense cap mètode, l’acció de desar es rebutja, per exemple: Choose a method: bank sign-in, account check, or both. ARE offers account check. Un país al qual cap ruta no dona servei es manté, només amb les seves alternatives: consulta Un país al qual cap ruta bancària dona servei.

​
L’ordre propi d’un país

El camp methods d’un país a bank_countries substitueix l’ordre del pas per a aquest país. La persona comença pel primer mètode i se li ofereix el segon com a alternativa.
Aquí el Regne Unit segueix l’ordre del pas, Noruega ofereix només l’inici de sessió al banc, i Mèxic comença per la comprovació del compte amb l’inici de sessió al banc com a alternativa. Un país amb methods establert a null, o sense aquesta clau, segueix l’ordre del pas. L’acció de desar es rebutja, sota bank_countries.<ISO3>, quan un país habilitat:
  • estableix methods com una llista buida, fins i tot en un país al qual cap ruta no dona servei, o
  • indica un mètode al qual cap ruta no dona servei allà, per exemple Account check is not available in NOR.
Un país al qual cap ruta no dona servei omet methods, o l’estableix a null, i ofereix només les seves alternatives: consulta Un país al qual cap ruta bancària dona servei.

​
A la consola

Al pas de Bank verification, Països i mètodes llista cada país amb el que ofereixen l’inici de sessió al banc i la comprovació del compte en cada país, i quin mètode va primer. Els seus valors predefinits configuren tots els països alhora: Un valor predefinit mai no deixa un país sense res: quan un país només disposa d’un dels dos mètodes, aquest es manté actiu.

​
Les dades financeres requereixen l’inici de sessió al banc

Només l’inici de sessió al banc llegeix saldos, transaccions i ingressos. Quan el pas els demana a bank_scopes i un país ofereix la comprovació del compte, una persona que es verifiqui mitjançant la comprovació del compte supera el pas sense aquestes dades. El pas no falla: el resultat llista allò que no s’ha recopilat a financial_data.not_collected.
not_collected és una llista buida sempre que el mètode hagi recopilat tot el que el pas demanava. Per exigir les dades, ofereix únicament l’inici de sessió al banc als països on les necessitis.

​
Configuració de la comprovació del compte

Aquestes claus només configuren la comprovació del compte. L’inici de sessió al banc manté la seva pròpia configuració. Els intents es comptabilitzen per mètode. bank_max_attempts compta els intents d’inici de sessió al banc, i un microdipòsit o una càrrega d’extracte també en consumeix un. bank_account_check_max_attempts compta les comprovacions del compte. El pas finalitza amb bank_attempts_exhausted_action un cop totes les vies que encara s’ofereixen a la persona per verificar-la, inclosa la càrrega d’un extracte, han esgotat els seus intents sense una connexió satisfactòria: consulta La càrrega d’un extracte bancari.

​
Com llegir el mètode al resultat

​
Decisió i webhooks

Cada pas de verificació bancària és un element de bank_verifications[] a la decisió de la sessió i a l’objecte decision dels webhooks status.updated. El seu camp method indica com s’ha verificat el compte: method és null fins que s’ha avaluat un compte, i none quan la persona ha continuat sense un banc abans que s’avalués cap intent: consulta Com llegir-ho al resultat. Llegeix method, i no ownership.method, per distingir els mètodes: ownership.method és la comparació de noms que ha generat la puntuació, com ara exact o fuzzy.
L’exemple només mostra els camps que es tracten en aquesta pàgina. Tots els camps es troben a l’esquema SessionDecision de la referència de l’API.

​
Regles del flux de treball

Les branques i les regles d’estat personalitzades llegeixen el mateix valor com a bank.method, etiquetat com a Bank Verification Method al constructor de regles, amb els valors Bank Sign-in, Account Check, Micro-deposits, Statement Upload i Continued Without a Bank. Una regla compara el valor del mètode, com ara una branca després d’un pas de Cribratge AML que envia a revisió una comprovació del compte amb una puntuació de risc alta:

​
Informe de la sessió

L’informe en PDF de la sessió indica el mètode a la seva fila Mètode de verificació.

​
Nodes desats abans dels mètodes

bank_open_banking_enabled i bank_account_lookup_enabled s’han retirat. Un node desat abans que existís bank_method_order ara s’executa amb l’ordre que definien els seus dos commutadors: On la comprovació del compte estava activada juntament amb l’inici de sessió al banc, la persona ara la veu com a alternativa al selector de bancs, Introdueix les dades del teu compte, no només quan el seu banc no està disponible. Un node amb ambdós commutadors desactivats, que només oferia microdipòsits o la càrrega d’extractes, es manté tal com està; si es desa posteriorment, caldrà activar almenys un dels dos mètodes. Durant una única versió, desar sense enviar bank_method_order però enviant qualsevol dels commutadors continuarà establint l’ordre a partir dels commutadors. Cada acció de desar torna a escriure ambdós commutadors segons si algun país ofereix l’inici de sessió al banc i si algun país ofereix la comprovació del compte. Utilitza bank_method_order i bank_countries.<ISO3>.methods a les noves integracions.

​
Preus

Cada mètode es factura al seu propi preu, per país. Consulta Preus de la verificació bancària per conèixer els preus de cada país.
  • L’inici de sessió al banc té el seu propi preu, i els complements de saldo i transaccions afegeixen cadascun el seu.
  • La comprovació del compte es factura un cop per cada comprovació a la qual el banc respongui: una coincidència, una coincidència propera, una no coincidència, un compte que no ha pogut verificar i un compte que no ha trobat. Un compte rebutjat tal com s’ha escrit no es factura mai.
Quan un país ofereix ambdós mètodes, una sessió pot costar qualsevol dels dos preus, segons el mètode que utilitzi la persona. La càrrega d’extractes i els microdipòsits s’inclouen sense cost addicional després d’un intent facturat. Una càrrega d’extracte sense cap intent bancari previ costa $0.20, i continuar sense banc no es factura mai: consulta Preus. L’API de comprovació del compte executa la mateixa comprovació des del teu backend, sense sessió, al mateix preu de comprovació de compte.

​
Provar al sandbox

Una aplicació de sandbox ofereix ambdós mètodes a tots els països, en l’ordre que defineix el pas, i no factura res. Amb l’ordre per defecte, la persona comença a l’inici de sessió al banc i selecciona Introdueix les dades del teu compte per executar la comprovació del compte. Per començar amb la comprovació del compte, estableix bank_method_order a ["account_lookup", "open_banking"]. Els darrers quatre caràcters del compte trien la resposta de la comprovació del compte: consulta Provar al sandbox.

​
Relacionat

Darrera modificació el 7 de novembre del 2026