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

# Comprovació de compte bancari: titularitat

> Didit confirma la titularitat del compte bancari sense iniciar sessió, només amb les dades introduïdes. IBAN, sort code, CLABE, CBU, IFSC i més.

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](https://docs.didit.me/ca/core-technology/bank-verification/verification-methods.md), 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](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md). Per comprovar un compte des del teu backend sense cap sessió, per exemple abans d'un pagament, utilitza l'[API de comprovació de comptes](https://docs.didit.me/ca/standalone-apis/bank-account-check.md).

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

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

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

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

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

**5. 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](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md) 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](https://docs.didit.me/ca/core-technology/bank-verification/verification-methods.md#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](#on-s’ofereix-la-comprovació), 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:

```json theme={null}
{
  "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](https://docs.didit.me/ca/core-technology/bank-verification/fallbacks.md#la-pujada-d’extracte-bancari). 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](https://docs.didit.me/ca/core-technology/bank-verification/verification-methods.md#les-dades-financeres-requereixen-l’inici-de-sessió-al-banc).

```json theme={null}
{
  "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](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md).

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:

> [tab] Germany (IBAN)
>
> | Resposta | IBAN |
> | - | - |
> | Coincidència | `DE43123456789012345678` |
> | `0001` | `DE62123456789012340001` |
> | `0002` | `DE35123456789012340002` |
> | `0003` | `DE08123456789012340003` |
> | `0004` | `DE78123456789012340004` |
> | `0005` | `DE51123456789012340005` |
> | `0006` | `DE24123456789012340006` |
> | `0009` | `DE40123456789012340009` |

> [tab] United Kingdom
>
> 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` |

> [tab] United States
>
> 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` |

> [tab] Mexico (CLABE)
>
> | Resposta | CLABE |
> | - | - |
> | Coincidència | `002010077777777771` |
> | `0001` | `002010077777780001` |
> | `0002` | `002010077777750002` |
> | `0003` | `002010077777720003` |
> | `0004` | `002010077777790004` |
> | `0005` | `002010077777760005` |
> | `0006` | `002010077777730006` |
> | `0009` | `002010077777740009` |

> [tab] Argentina (CBU)
>
> | Resposta | CBU |
> | - | - |
> | Coincidència | `2850590940090418135201` |
> | `0001` | `2850590940090418160001` |
> | `0002` | `2850590940090418170002` |
> | `0003` | `2850590940090418180003` |
> | `0004` | `2850590940090418190004` |
> | `0005` | `2850590940090418100005` |
> | `0006` | `2850590940090418110006` |
> | `0009` | `2850590940090418140009` |

> [tab] India
>
> 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](https://docs.didit.me/ca/standalone-apis/bank-account-check.md) respon a una clau de sandbox a partir d'aquestes mateixes terminacions, sense cap sessió.

Consulta [Proves en sandbox](https://docs.didit.me/ca/integration/sandbox-testing.md) per saber com funcionen les aplicacions de sandbox en general.


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