Comprovació de compte bancari: titularitat

La comprovació de compte confirma que un compte bancari pertany a la persona que el teu flux de treball ja ha verificat, a partir de les dades del compte que introdueix. No hi ha cap inici de sessió bancari ni cap pantalla de consentiment: la persona introdueix el seu compte tal com s’escriu al seu país, i el banc confirma el nom que hi figura comparant-lo amb el nom verificat en un pas anterior. És un dels dos mètodes de Verificació bancària, juntament amb l’inici de sessió bancari, i el valor del mètode és account_lookup. La càrrega d’extractes i els microdipòsits continuen sent alternatives de reserva després de tots dos, i la persona sempre pot continuar sense fer servir un banc. Per comprovar un compte des del teu backend sense cap sessió, per exemple abans d’un pagament, utilitza l’API de comprovació de comptes.

La Verificació bancària confirma qui és el titular d’un compte comparant-lo amb una identitat que un altre pas ha establert, de manera que per si sola no és una prova d’identitat. Posa Verificació d’identitat, Validació en bases de dades, un qüestionari o expected_details abans del pas. La persona mai escriu un nom per a la comprovació: Didit sempre compara el nom que la sessió ja ha verificat.

Com funciona

La persona tria el seu país

Al pas de Verificació bancària, la persona tria un país que el pas ofereix. Quan la comprovació de compte és la primera opció allà, el pas obre un formulari breu en el format de compte d’aquell país. Quan l’inici de sessió bancari va primer, la persona tria Introdueix les dades del teu compte per arribar al formulari.

La persona escriu el seu compte

Per exemple un IBAN, un sort code i un número de compte, o una CLABE. El flux de verificació crea el formulari a partir del que retorna l’API per a aquest país, de manera que un país que Didit afegeixi més endavant no requereix cap canvi per part teva.

Didit comprova primer el format

Abans de facturar res, Didit comprova cada valor: la seva longitud, els seus caràcters, els seus dígits de control i, en el cas d’un IBAN, que pertanyi al país seleccionat. Un valor incorrecte es rebutja indicant el camp a corregir. La persona el corregeix directament, i no es consumeix cap intent.

El banc comprova el nom que figura al compte

Didit fa una comprovació comparant amb el nom que la sessió ha verificat. Qualsevol altra informació que enviï el client s’ignora.

El pas pren una decisió

La resposta es converteix en un resultat de titularitat, i les accions del pas el transformen en el veredicte exactament com ho fan per a l’inici de sessió bancari.

On s’ofereix la comprovació

La cobertura és per país. En producció, avui la comprovació funciona a Nigèria, Ghana i Kenya. Didit l’activa país per país, un cop disposa d’una ruta tarifada allà; un país que no en tingui no l’ofereix, i els preus de la Verificació bancària mostren sempre la llista actualitzada. Els països s’afegeixen progressivament, i el pas sempre llegeix la llista actualitzada, de manera que mai has de modificar la teva integració quan se n’afegeix un. Dins d’un país cobert, els mètodes del pas decideixen si la persona la veu:

L’ordre del pas. bank_method_order defineix quins mètodes ofereix cada país i quin va primer. El valor per defecte, ["open_banking", "account_lookup"], comença amb l’inici de sessió bancari i ofereix la comprovació de compte com a alternativa.
L’ordre propi d’un país. methods en un país a bank_countries substitueix l’ordre del pas allà, per exemple ["account_lookup"] només per a la comprovació de compte, o ["account_lookup", "open_banking"] per començar amb ella.
Un banc que no està disponible. Quan un país ofereix la comprovació de compte, també serveix de suport per a un banc en què l’inici de sessió bancari s’hagi degradat o estigui fora de servei: el pas es desplaça al formulari de compte abans de demanar cap consentiment, mentre a la persona li quedin comprovacions de compte disponibles.
La comprovació s’executa a les rutes pròpies de Didit. Un pas que s’executa amb el teu propi proveïdor del marketplace (provider_key) només l’ofereix amb fallback_to_native activat.
Comptes d’empresa. En una sessió de verificació d’empreses, la comprovació compara un compte d’empresa amb l’empresa verificada, als països on Didit comprova comptes d’empresa.

Consulta Tria els mètodes per país per conèixer les regles que s’apliquen quan es desa.

Què escriu la persona

Aquests són els formats de compte que entén el formulari. No són una llista de cobertura: si la comprovació s’executa en un país depèn d’on s’ofereix, i el pas sempre mostra els camps exactes per a aquest país.

Format de compte	Països	Què escriu la persona
IBAN	Països que utilitzen IBAN	L’IBAN complet, que ha de pertànyer al país seleccionat
Sort code i número de compte	Regne Unit	Un sort code de 6 xifres i un número de compte de 8 xifres
Routing number i número de compte	Estats Units	Un routing number ABA de 9 xifres i el número de compte
Número de trànsit i d’entitat	Canadà	El número de trànsit i d’entitat de 8 xifres (els 5 dígits de trànsit seguits dels 3 dígits d’entitat) i el número de compte
BSB i número de compte	Austràlia	Un BSB de 6 xifres i el número de compte
CLABE	Mèxic	La CLABE de 18 xifres, que ja indica el banc
CBU o CVU	Argentina	El CBU o CVU de 22 xifres, que ja indica el banc
IFSC i número de compte	Índia	L’IFSC d’11 caràcters i el número de compte
NUBAN i codi de banc	Nigèria	El NUBAN de 10 xifres i el codi o BIC del banc
Número de compte	Altres països	El número de compte, i un codi de banc o BIC on el país ho requereixi

En alguns països, el formulari també demana un número de registre: per a comptes d’empresa, i en alguns països per a qualsevol compte. Els espais, guions i punts s’eliminen i les lletres es passen a majúscules abans de comprovar un valor, de manera que la persona pot escriure un compte tal com l’imprimeix el seu banc.

Activa-la

Un pas nou ofereix la comprovació del compte per defecte, com a opció de reserva per a l’inici de sessió bancari. Per començar directament amb aquesta opció, o per oferir-la sola, posa account_lookup en primer lloc a l’ordre:

{
  "bank_method_order": ["account_lookup", "open_banking"]
}

Aquestes configuracions defineixen la comprovació:

Configuració	Efecte en la comprovació del compte
`bank_method_order`, `bank_countries.<ISO3>.methods`	Si un país ofereix la comprovació, i si apareix abans o després de l’inici de sessió bancari.
`bank_countries`	La comprovació només s’executa als països que ofereix el pas.
`bank_reference_identity`	El pas el nom verificat del qual es fa servir per comprovar el compte.
`bank_account_check_max_attempts`	Quantes comprovacions té la persona, d’`1` a `5` (`3` per defecte). Un recompte independent de `bank_max_attempts` de l’inici de sessió bancari.
`bank_account_check_accept_close_match`	Activat (per defecte): una coincidència propera passa a la confirmació de coincidència propera, o a `bank_partial_match_action`. Desactivat: cada coincidència propera es considera sense coincidència.
`bank_name_match_threshold`, `bank_partial_match_floor`	Els mateixos intervals de puntuació de nom que a l’inici de sessió bancari: una coincidència igual o superior al llindar (85 per defecte), i una coincidència propera, l’interval de coincidència parcial, entre el mínim (70 per defecte) i el llindar.
`bank_use_provider_score`	Activat (per defecte): la pròpia puntuació de nom de la comprovació decideix quan és superior a la de Didit, o quan la comprovació retorna una puntuació però cap nom de titular, i `ownership.method` mostra llavors `provider_only`. Desactivat: una resposta sense nom de titular és `not_verifiable`.
`bank_suggest_holder_name`	Activat (per defecte): en una coincidència propera que indica el titular, la persona veu el nom i confirma que és el seu o prova amb un altre compte.

Resultats

Comprovacions que retornen una resposta

Cadascuna d’aquestes es factura una vegada i consumeix una de les comprovacions de compte de la persona (bank_account_check_max_attempts). Fins que el pas no es completi, la persona pot tornar-ho a provar amb un altre compte mentre li quedin intents. El resultat és a ownership.result, excepte en el cas d’un compte que no existeix, que es troba a connection.reason_code.

La comprovació retorna	Resultat	Què decideix
El compte pertany a la persona verificada	`match`	El pas s’aprova, tret que una altra de les seves comprovacions indiqui el contrari.
Una coincidència propera que indica el titular	`partial_match`	Amb `bank_suggest_holder_name` activat, la persona confirma el nom o prova amb un altre compte. Confirmar finalitza el pas a `bank_partial_match_action` (`REVIEW` per defecte).
Una coincidència propera amb una puntuació però sense nom de titular	`partial_match`	`bank_partial_match_action` (`REVIEW` per defecte). `ownership.method` mostra `provider_only`. Això requereix tenir activat `bank_use_provider_score`, l’opció per defecte; si està desactivat, la resposta és `not_verifiable`.
El compte pertany a una altra persona	`no_match`	`bank_no_match_action` (`DECLINE` per defecte).
Una resposta que no ha comparat cap nom	`not_verifiable`	`bank_not_verifiable_action` (`REVIEW` per defecte).
No existeix cap compte amb aquestes dades	`ACCOUNT_NOT_FOUND`	La persona pot provar amb un altre compte mentre li quedin intents.

Amb bank_account_check_accept_close_match desactivat, totes dues coincidències properes passen a ser no_match, amb el codi de motiu OWNER_NAME_MISMATCH: mai no es demana a la persona que confirmi el nom, i bank_no_match_action decideix. L’inici de sessió bancari manté les seves coincidències properes en qualsevol cas. Un cop la persona ha esgotat totes les comprovacions de compte, i tots els intents d’inici de sessió bancari on el país també ofereixi inici de sessió bancari, sense una connexió satisfactòria, el pas roman obert mentre encara li ofereixi la càrrega d’un extracte amb intents disponibles: consulta La càrrega d’extractes. Quan no queda cap via, el pas finalitza a bank_attempts_exhausted_action (DECLINE per defecte), tret que un intent anterior ja hagi arribat a un veredicte, com ara una no coincidència de nom. Aquest veredicte es manté llavors vigent.

Resultats que mai no es facturen

Cap d’aquests consumeix una comprovació. Cadascun es mostra a connection.reason_code.

Què passa	Codi de motiu	Què passa a continuació
El compte és rebutjat tal com s’ha escrit, per la comprovació de format de Didit o pel banc	`INVALID_ACCOUNT_INPUT`, mentre l’intent roman obert	S’indica a la persona quin camp ha de corregir i el corregeix.
La comprovació no està disponible en aquest moment	`PROVIDER_UNAVAILABLE`	La persona pot tornar-ho a provar.
La sessió no té cap nom verificat per comparar	`REFERENCE_IDENTITY_MISSING`	La comprovació mai no s’executa. El pas finalitza a `bank_reference_identity_missing_action` (`REVIEW` per defecte).

A la decisió

La decisió de la sessió llista el pas sota bank_verifications[]. Un cop s’ha avaluat un compte, method mostra account_lookup. Mentre no s’hagi avaluat cap compte, method i ownership són null, i connection.reason_code indica per què, per exemple ACCOUNT_NOT_FOUND, PROVIDER_UNAVAILABLE o REFERENCE_IDENTITY_MISSING. No se selecciona cap banc per a la comprovació, de manera que connection.institution_id, connection.institution_name i connection.oauth són null, i connection.institution_country és el país que ha triat la persona. Didit no manté cap accés al compte un cop completat el pas, per la qual cosa una comprovació que hagi finalitzat amb coincidència mostra connection.status: revoked amb reason_code: VERIFICATION_COMPLETED. El resultat en si roman a la sessió. Una comprovació del compte no llegeix saldos, transaccions ni ingressos. Quan el pas els sol·licita, financial_data.not_collected els enumera; consulta Les dades financeres requereixen l’inici de sessió bancari.

{
  "bank_verifications": [
    {
      "status": "Approved",
      "method": "account_lookup",
      "connection": {
        "status": "revoked",
        "institution_id": null,
        "institution_name": null,
        "institution_country": "NGA",
        "oauth": null,
        "attempts": 1,
        "reason_code": "VERIFICATION_COMPLETED"
      },
      "ownership": {
        "result": "match",
        "method": "exact"
      },
      "financial_data": {
        "balances": null,
        "transactions": null,
        "income": null,
        "categorization": null,
        "not_collected": []
      },
      "billing": {
        "route": "native",
        "billed": true,
        "marketplace_fee": null,
        "usage_type": "bank_verification"
      }
    }
  ]
}

L’exemple només mostra els camps que es tracten en aquesta pàgina. Un cop avaluat un compte, consulta method per distingir una comprovació del compte d’un inici de sessió bancari: és l’únic camp pensat per a això.

En regles de flux de treball i informes

Branques i regles d’estat: bank.method és account_lookup (Comprovació del compte al creador de regles), i bank.reason_code pot ser ACCOUNT_NOT_FOUND.
Informe PDF de la sessió: la fila Mètode de verificació mostra Comprovació del compte.

Preus

Cada comprovació que retorna una resposta és un càrrec de Bank Verification: una coincidència, una coincidència propera, una no coincidència, un compte que no s’ha pogut verificar i un compte que no s’ha trobat es facturen tots. Un valor rebutjat abans de la comprovació, una comprovació que no està disponible i una sessió sense cap nom verificat per comparar mai no es facturen. El preu s’estableix per país: consulta Preus de Bank Verification. La comprovació de compte és un mètode de pagament per separat, mai un recurs de reserva: bank_fallback_used_action no s’activa per a aquest mètode. Després d’una comprovació facturada, els microdipòsits i la càrrega de l’extracte s’inclouen sense cost addicional en la mateixa sessió, quan el pas els activa i el país els ofereix.

Prova-ho en sandbox

En una aplicació de sandbox, la comprovació s’executa en un servei simulat i no es factura res. El sandbox ofereix ambdós mètodes a tots els països, en l’ordre que estableix el pas: amb l’ordre per defecte, selecciona Introdueix les dades del teu compte per executar la comprovació, o bé defineix bank_method_order com a ["account_lookup", "open_banking"] per començar per aquest. Els últims quatre caràcters del compte que escriu la persona (l’IBAN, altrament el número de compte) trien la resposta. Qualsevol altra terminació coincideix amb el nom verificat.

Acaba en	Resposta
`0001`	Una coincidència propera que indica el nom del titular: es demana a la persona que confirmi el nom. Amb `bank_account_check_accept_close_match` desactivat, una no coincidència.
`0002`	Una coincidència propera sense nom del titular: `bank_partial_match_action` decideix. Amb `bank_use_provider_score` desactivat, la resposta és `not_verifiable`; amb `bank_account_check_accept_close_match` desactivat, una no coincidència.
`0003`	Sense coincidència: el compte pertany a una altra persona. Consumeix una comprovació.
`0004`	S’ha obtingut una resposta, però no s’ha comparat cap nom (`not_verifiable`). Consumeix una comprovació.
`0005`	La comprovació no està disponible (`PROVIDER_UNAVAILABLE`). Es pot reintentar sense cost.
`0006`	Cap compte amb aquestes dades (`ACCOUNT_NOT_FOUND`). Consumeix una comprovació.
`0009`	Rebutjat tal com s’ha escrit: es demana a la persona que corregeixi el camp. L’intent roman obert.

El sandbox registra cada comprovació que ha obtingut una resposta com a ús sense cost, de manera que pots veure quines comprovacions facturaria una sessió de producció. Un IBAN, un CLABE i un CBU porten dígits de control, de manera que no pots simplement canviar-ne els últims quatre caràcters. Utilitza aquests valors, que superen totes les comprovacions de format:

Resposta	IBAN
Coincidència	`DE43123456789012345678`
`0001`	`DE62123456789012340001`
`0002`	`DE35123456789012340002`
`0003`	`DE08123456789012340003`
`0004`	`DE78123456789012340004`
`0005`	`DE51123456789012340005`
`0006`	`DE24123456789012340006`
`0009`	`DE40123456789012340009`

Sort code 123456, amb:

Resposta	Número de compte
Coincidència	`12345678`
`0001`	`12340001`
`0002`	`12340002`
`0003`	`12340003`
`0004`	`12340004`
`0005`	`12340005`
`0006`	`12340006`
`0009`	`12340009`

Routing number 021000021, amb:

Resposta	Número de compte
Coincidència	`000123456789`
`0001`	`000123450001`
`0002`	`000123450002`
`0003`	`000123450003`
`0004`	`000123450004`
`0005`	`000123450005`
`0006`	`000123450006`
`0009`	`000123450009`

Resposta	CLABE
Coincidència	`002010077777777771`
`0001`	`002010077777780001`
`0002`	`002010077777750002`
`0003`	`002010077777720003`
`0004`	`002010077777790004`
`0005`	`002010077777760005`
`0006`	`002010077777730006`
`0009`	`002010077777740009`

Resposta	CBU
Coincidència	`2850590940090418135201`
`0001`	`2850590940090418160001`
`0002`	`2850590940090418170002`
`0003`	`2850590940090418180003`
`0004`	`2850590940090418190004`
`0005`	`2850590940090418100005`
`0006`	`2850590940090418110006`
`0009`	`2850590940090418140009`

IFSC ALLA0211480, amb:

Resposta	Número de compte
Coincidència	`123456789007`
`0001`	`123456780001`
`0002`	`123456780002`
`0003`	`123456780003`
`0004`	`123456780004`
`0005`	`123456780005`
`0006`	`123456780006`
`0009`	`123456780009`

L’API de comprovació de compte respon a una clau de sandbox a partir d’aquestes mateixes terminacions, sense cap sessió. Consulta Proves en sandbox per saber com funcionen les aplicacions de sandbox en general.

Autenticació

Verificació

Monitoratge

Plataforma

Comprovació de compte bancari: titularitat

Com funciona

On s’ofereix la comprovació

Què escriu la persona

Activa-la

Resultats

Comprovacions que retornen una resposta

Resultats que mai no es facturen

A la decisió

En regles de flux de treball i informes

Preus

Prova-ho en sandbox

​Com funciona

​On s’ofereix la comprovació

​Què escriu la persona

​Activa-la

​Resultats

​Comprovacions que retornen una resposta

​Resultats que mai no es facturen

​A la decisió

​En regles de flux de treball i informes

​Preus

​Prova-ho en sandbox

Com funciona

On s’ofereix la comprovació

Què escriu la persona

Activa-la

Resultats

Comprovacions que retornen una resposta

Resultats que mai no es facturen

A la decisió

En regles de flux de treball i informes

Preus

Prova-ho en sandbox