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

# Mètodes de verificació bancària: inici de sessió o compte

> Didit ofereix inici de sessió bancari o comprovació de compte: què demostren i retornen, i com triar-los i ordenar-los per país.

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.

> [!NOTE]
>
> 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](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md) sempre mostren què ofereix cada país actualment.

> [!NOTE]
>
> 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

| | Inici de sessió al banc | Comprovació del compte |
| - | - | - |
| Valor del mètode | `open_banking` | `account_lookup` |
| Què fa la persona | Inicia sessió al seu banc i comparteix el compte. | Escriu les dades del compte: un IBAN, un codi d'ordenació bancària i un número de compte, una CLABE, etc. Sense iniciar sessió. |
| Què demostra | El control del compte, a més del titular que retorna el banc. | Que el nom del titular que té el banc per a aquest compte coincideix amb el nom verificat. |
| Dades que afegeix | Saldos, transaccions i ingressos, quan el pas els sol·licita. | Cap: només la titularitat. |
| Ús típic | Alta, préstecs, capacitat de pagament, clients d'alt risc. | Pagaments i retirades, alta amb poca fricció, països sense inici de sessió al banc. |

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](https://docs.didit.me/ca/core-technology/bank-verification/account-check.md) 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](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md).

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

```json theme={null}
{
  "bank_method_order": ["open_banking", "account_lookup"]
}
```

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](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md#un-país-al-qual-no-dona-servei-cap-ruta-bancària).

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

```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"]
    }
  }
}
```

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](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md#un-país-al-qual-no-dona-servei-cap-ruta-bancària).

### 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:

| Valor predefinit | Ordre |
| - | - |
| Inici de sessió al banc, comprovació del compte com a alternativa (per defecte) | `["open_banking", "account_lookup"]` |
| Només inici de sessió al banc | `["open_banking"]` |
| Només comprovació del compte | `["account_lookup"]` |
| Comprovació del compte, inici de sessió al banc com a alternativa | `["account_lookup", "open_banking"]` |

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

```json theme={null}
"financial_data": {
  "balances": null,
  "transactions": null,
  "income": null,
  "categorization": null,
  "not_collected": ["balances", "transactions"]
}
```

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

| Camp de configuració | Efecte |
| - | - |
| `bank_account_check_accept_close_match` | Activat (per defecte): un nom que el banc puntua entre `bank_partial_match_floor` i `bank_name_match_threshold` és una coincidència propera. La persona confirma el nom que té el banc quan `bank_suggest_holder_name` està activat, i `bank_partial_match_action` decideix. Desactivat: aquesta coincidència propera es considera una no coincidència (`OWNER_NAME_MISMATCH`), decidida per `bank_no_match_action`, i consumeix l'intent. |
| `bank_account_check_max_attempts` | Quantes comprovacions del compte rep la persona, d'`1` a `5`, `3` quan no s'indica: quantes vegades pot escriure les dades del compte per a una comprovació a la qual el banc respongui. Un compte rebutjat tal com s'ha escrit, o una comprovació a la qual el banc no ha pogut respondre, no en consumeix cap. |

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](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md#la-pujada-d’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ó](https://docs.didit.me/ca/sessions-api/retrieve-session.md#verificació-bancària) i a l'objecte `decision` dels [webhooks `status.updated`](https://docs.didit.me/ca/integration/webhooks#matrius-plurals-de-v3-important). El seu camp `method` indica com s'ha verificat el compte:

| `method` | Es mostra com |
| - | - |
| `open_banking` | Inici de sessió al banc |
| `account_lookup` | Comprovació del compte |
| `microdeposits` | Microdipòsits |
| `statement` | Càrrega d'extracte |
| `none` | S'ha continuat sense banc |

`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](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md#llegeix-ho-en-el-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`.

```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'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](https://docs.didit.me/ca/sessions-api/retrieve-session.md).

### 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:

```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"
}
```

### 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:

| `bank_open_banking_enabled` | `bank_account_lookup_enabled` | El node s'executa amb |
| - | - | - |
| Activat o no definit | Desactivat o no definit | `["open_banking"]` |
| Activat o no definit | Activat | `["open_banking", "account_lookup"]` |
| Desactivat | Activat | `["account_lookup"]` |

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](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md) 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](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md#preus). L'[API de comprovació del compte](https://docs.didit.me/ca/standalone-apis/bank-account-check.md) 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](https://docs.didit.me/ca/core-technology/bank-verification/account-check.md#prova-ho-en-sandbox).

## Relacionat

* [Comprovació de compte](https://docs.didit.me/ca/core-technology/bank-verification/account-check.md): formats de compte, resultats i valors de sandbox.
* [Quan la persona no pot verificar el seu banc](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md): alternatives, Continuar sense el teu banc i els seus resultats.
* [API de comprovació de compte](https://docs.didit.me/ca/standalone-apis/bank-account-check.md): comprova un compte per rebre pagaments des del teu backend, sense cap sessió.
* [Claus de configuració de verificació bancària](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#verificació-bancària): cada clau del pas.
* [Proves en sandbox](https://docs.didit.me/ca/integration/sandbox-testing.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.