> ## 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. # API de vérification de compte bancaire pour versements > Vérifiez avec Didit qu'un compte bancaire appartient à la personne ou à l'entreprise indiquée avant tout versement. Sans session. > [!NOTE] > > En production, la vérification de compte fonctionne au Nigeria, au Ghana et au Kenya. > Un autre pays répond `404` avec `code: country_not_covered` et n'est pas facturé. > D'autres pays seront ajoutés au fil du temps, et [Tarifs de la vérification bancaire](https://docs.didit.me/fr/getting-started/bank-verification-pricing.md) indique toujours ce que chaque pays propose aujourd'hui. Votre backend envoie le nom et le compte, puis lit le résultat. Il s'agit de la [vérification de compte](https://docs.didit.me/fr/core-technology/bank-verification/account-check.md) de l'étape Vérification bancaire, sans la personne. ## Envoyez le compte selon la forme utilisée par son pays | Pays | `account` | | - | - | | Pays utilisant l'IBAN | `{"iban": "..."}` | | Royaume-Uni | `{"sort_code": "...", "account_number": "..."}` | | États-Unis | `{"routing_number": "...", "account_number": "..."}` | | Canada | `{"transit_institution": "...", "account_number": "..."}` | | Australie | `{"bsb": "...", "account_number": "..."}` | | Inde | `{"ifsc": "...", "account_number": "..."}` | | Nigeria | `{"bank_code": "...", "account_number": "..."}`, avec le code NIP de la banque à 6 chiffres (Access Bank est `000014`) et le NUBAN à 10 chiffres | | Ghana | `{"bank_code": "...", "account_number": "..."}`, avec le code de la banque à 3 lettres (GCB Bank est `GCB`) | | Kenya | `{"bank_code": "...", "account_number": "..."}`, avec le code de la banque à 2 chiffres (KCB est `01`) | | Mexique | `{"clabe": "..."}` | | Argentine | `{"cbu_cvu": "..."}` | Certains pays demandent aussi un `bic`, et pour un compte d'entreprise un `registration_id`. Les espaces, tirets et points sont ignorés. Une clé requise par la vérification du pays et non fournie entraîne un `400` qui la nomme, par exemple `"field": "account.bank_code", "reason": "required"`. Envoyez `holder.full_name` pour vérifier le compte d'une personne, ou `holder.business_name` pour vérifier celui d'une entreprise. ## Envoyez le consentement du titulaire du compte Dans certains pays, la vérification de compte exige le consentement explicite du titulaire du compte avant chaque vérification. Demandez-le dans votre produit, puis envoyez `"consent": true`. Sans ce consentement, une vérification dans ces pays est refusée avec un `400` (`field: consent`, `reason: required`) et n'est pas facturée. Ailleurs, `consent` est facultatif, et lorsque vous l'envoyez, Didit l'enregistre avec les frais de la vérification. Une clé sandbox demande le consentement dans les mêmes pays qu'une clé de production. ## Lire le résultat | `result` | Signification | Étape suivante habituelle | | - | - | - | | `match` | La banque détient le compte au nom que vous avez envoyé. | Envoyez l'argent. | | `close_match` | La banque détient le compte sous un nom proche. `holder_name` est ce nom, lorsque la banque l'a renvoyé. | Comparez `holder_name`, ou demandez à la personne de confirmer. | | `no_match` | La banque détient le compte sous un autre nom, ou ce compte n'existe pas. | N'envoyez pas l'argent. | | `cannot_verify` | La banque a répondu sans comparer le nom, par exemple pour un compte bloqué ou clôturé. | Appliquez votre propre politique, par exemple demandez un autre compte. | ## Facturation et nouvelles tentatives Chaque vérification à laquelle la banque répond est facturée une fois au [prix de la vérification de compte](https://docs.didit.me/fr/getting-started/bank-verification-pricing.md) du pays du compte, quel que soit le résultat. Une requête qui reçoit une erreur n'est jamais facturée : un corps de requête refusé (`400`), un crédit insuffisant (`402`), un pays pour lequel la vérification de compte n'est pas encore disponible (`404`) ou une banque qui n'a pas pu répondre (`503`). Il n'existe ni clé d'idempotence ni endpoint pour relire une vérification. Une requête réessayée lance une nouvelle vérification, avec un nouveau `request_id`, et est de nouveau facturée : conservez donc la réponse. Didit ne conserve que les frais, avec l'identifiant de la requête, le pays, le résultat et le compte masqué, jamais le nom ni le numéro complet du compte. ## Testez-le dans le sandbox Une clé API sandbox n'appelle aucune banque et n'entraîne aucuns frais. Les 4 derniers caractères de l'IBAN, sinon ceux du numéro de compte, déterminent la réponse : | Se termine par | Réponse | | - | - | | `0001` | `close_match`, avec un `holder_name` | | `0002` | `close_match`, `holder_name: null` | | `0003`, `0006` | `no_match` | | `0004` | `cannot_verify` | | `0005` | `503`, `account_check_unavailable` | | `0009` | `400`, `reason: rejected` | | Tout autre cas | `match` | Un IBAN, un CLABE et un CBU comportent des chiffres de contrôle : utilisez les [valeurs sandbox](https://docs.didit.me/fr/core-technology/bank-verification/account-check.md#tester-dans-la-sandbox) qui passent toutes les vérifications de format. ## Accès Authentifiez-vous avec le `x-api-key` de votre application, ou avec son jeton bearer obtenu avec les identifiants client. Une clé API à portée limitée a besoin de l'accès en écriture aux sessions. L'endpoint partage la limite d'écriture de 300 requêtes par minute et par clé API. ## OpenAPI ````yaml fr/openapi-25.json POST /v3/bank/account-check/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/bank/account-check/: post: tags: - Standalone APIs summary: Vérifier un compte bancaire description: >- Vérifiez qu'un compte bancaire appartient bien à la personne ou à l'entreprise que vous indiquez, avant d'y envoyer des fonds. Aucune session ni connexion : envoyez le nom et le compte, lisez le résultat. Il s'agit de la [vérification de compte](/fr/core-technology/bank-verification/account-check) de l'étape Bank Verification, exécutée depuis votre backend. **Ce que vous envoyez.** Le `country` du compte (ISO 3166-1 alpha-3), le numéro de `account` tel que ce pays l'écrit, et le nom du titulaire (`holder`) : `full_name` pour une personne physique ou `business_name` pour une entreprise. Un nom d'entreprise permet de vérifier un compte professionnel. **Ce que vous recevez.** Le champ `result` vaut `match`, `close_match`, `no_match` ou `cannot_verify`. Lors d'un `close_match`, `holder_name` est le nom sous lequel la banque détient le compte, si la banque l'a renvoyé. Le champ `account` est renvoyé masqué, à l'exception de ses 4 derniers caractères. **Facturation.** Chaque vérification à laquelle la banque répond est facturée une fois au tarif de vérification de compte du pays du compte, quel que soit le résultat : un `no_match`, un compte inexistant et un `cannot_verify` sont également facturés. Une requête ayant renvoyé une erreur n'est jamais facturée. **Chaque requête constitue une nouvelle vérification.** Il n'y a pas de clé d'idempotence ni d'endpoint permettant de relire une vérification passée ; par conséquent, une requête réessayée est exécutée et facturée à nouveau. Enregistrez la réponse. **Sandbox.** Utilisez une clé API sandbox avec les coordonnées de compte fictives fournies. Une clé sandbox n'appelle aucune banque et n'est pas facturée. Les 4 derniers caractères de l'IBAN (ou à défaut, du numéro de compte) déterminent la réponse : `0001` un `close_match` avec un `holder_name`, `0002` un `close_match` sans celui-ci, `0003` et `0006` un `no_match`, `0004` `cannot_verify`, `0005` une erreur `503` et `0009` une erreur `400`. Toute autre fin de chaîne donne un `match`. **Clés API.** Une clé API avec restrictions de portée nécessite un accès en écriture aux sessions. operationId: post_v3_bank_account_check requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckRequest' examples: Person, Nigeria: summary: >- Un code bancaire et un numéro de compte, vérifiés par rapport au nom d'une personne value: country: NGA account: bank_code: '000014' account_number: '0123450001' holder: full_name: Maria Oliveira vendor_data: payout_20481 Company, Nigeria: summary: >- Un code bancaire et un numéro de compte, vérifiés par rapport au nom d'une entreprise value: country: NGA account: bank_code: '000014' account_number: '0123456789' holder: business_name: Northwind Trading Ltd responses: '200': description: >- La banque a répondu. La vérification est facturée, quel que soit le résultat. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckResponse' examples: Close match: summary: La banque détient le compte sous un nom proche value: request_id: c2f4a9e0-7b1d-4c3a-9e55-1d0a6b8f2a47 result: close_match holder_name: MARIA R OLIVEIRA account: '****0001' vendor_data: payout_20481 created_at: '2026-10-21T14:32:08Z' Match: summary: La banque détient le compte sous le nom envoyé value: request_id: 5b0e2d7c-41a8-4f6e-9c3b-8e7d1a2f6c90 result: match holder_name: null account: '****6789' vendor_data: null created_at: '2026-10-21T14:35:41Z' '400': description: >- Refusé tel quel, et non facturé. `field` indique le champ du corps à corriger et `reason` en précise la raison, avec les mêmes motifs que ceux affichés dans le formulaire de compte hébergé. Seul le premier champ refusé est signalé. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Missing field: summary: La vérification pour ce pays nécessite un code bancaire value: detail: The bank code is not valid (required). code: invalid_account_input field: account.bank_code reason: required Invalid IBAN: summary: L'IBAN n'a pas la bonne longueur pour son pays value: detail: The iban is not valid (length). code: invalid_account_input field: account.iban reason: length Refused by the bank: summary: La banque a refusé le compte tel qu'envoyé value: detail: The account was refused as typed (rejected). code: invalid_account_input field: account.account_number reason: rejected No name: summary: '`holder` ne comporte ni `full_name` ni `business_name`' value: detail: >- Send full_name for a person or business_name for a company. code: invalid_account_input field: holder reason: required Consent required: summary: >- La vérification du compte pour ce pays nécessite le consentement du titulaire du compte value: detail: >- Account checks in this country need the account holder's explicit consent. Ask for it, then send `consent=true`. code: invalid_account_input field: consent reason: required '401': description: La clé API restreinte a expiré. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Expired key: summary: La date d'expiration de la clé est dépassée value: detail: This API key has expired. '402': description: >- La vérification ne peut pas être payée, elle n'a donc pas été exécutée. Rechargez votre solde, puis renvoyez-la. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Out of credit: summary: Votre solde ne permet pas de couvrir une vérification value: detail: >- You don't have enough credits to perform this request. Please top up at https://business.didit.me code: insufficient_credits Not in your contract: summary: >- Votre contrat ne prévoit aucun tarif pour l'API Account check value: detail: >- Your contract does not price the Account check API. Contact your account manager. code: contract_rate_missing '403': description: >- L'en-tête `x-api-key` ou le bearer token est manquant ou invalide, la requête provient d'une adresse hors de la liste d'adresses IP de la clé, ou une clé restreinte n'a pas d'accès en écriture aux sessions. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Missing or invalid credentials: summary: Aucune clé API ou token valide value: detail: You do not have permission to perform this action. No sessions write: summary: Une clé restreinte sans accès en écriture aux sessions value: detail: This API key has no write access to sessions. '404': description: >- Aucune vérification de compte ne prend encore en charge ce compte, donc rien n'a été vérifié ni facturé. `country_not_covered` : aucune ne prend en charge son pays, ou son type de compte (personne physique ou entreprise) dans ce pays. `bank_not_covered` : aucune ne prend en charge sa banque. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Country not covered: summary: Aucune vérification de compte ne prend en charge le pays value: detail: No account check serves this country yet. code: country_not_covered Bank not covered: summary: >- Aucune vérification de compte ne prend en charge la banque du compte value: detail: No account check serves this account's bank yet. code: bank_not_covered '429': $ref: '#/components/responses/RateLimitedWrite' '503': description: >- La banque n'a pas pu répondre. Rien n'a été vérifié ni facturé ; renvoyez la vérification plus tard. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Unavailable: summary: La banque n'a pas répondu value: detail: >- The account check is temporarily unavailable and this request was not charged. Please try again. code: account_check_unavailable security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST https://verification.didit.me/v3/bank/account-check/ \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "country": "NGA", "account": {"bank_code": "000014", "account_number": "0123450001"}, "holder": {"full_name": "Maria Oliveira"}, "vendor_data": "payout_20481" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.bank.account_check( country="NGA", account={ "account_number": "0123450001", "bank_code": "000014", }, holder={ "full_name": "Maria Oliveira", }, vendor_data="payout_20481", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.bank.accountCheck({ country: "NGA", account: { account_number: "0123450001", bank_code: "000014", }, holder: { full_name: "Maria Oliveira", }, vendor_data: "payout_20481", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Bank.AccountCheck(ctx, didit.BankAccountCheckRequest{\n\tCountry: \"NGA\",\n\tAccount: didit.BankAccountCheckRequestAccount{\n\t\tAccountNumber: didit.String(\"0123450001\"),\n\t\tBankCode: didit.String(\"000014\"),\n\t},\n\tHolder: didit.BankAccountCheckHolder{\n\t\tFullName: didit.String(\"Maria Oliveira\"),\n\t},\n\tVendorData: didit.String(\"payout_20481\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.BankAccountCheckHolder; import me.didit.types.BankAccountCheckPersonHolder; import me.didit.types.BankAccountCheckRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.bank().accountCheck(BankAccountCheckRequest.builder() .country("NGA") .account(BankAccountCheckRequest.Account.builder() .accountNumber("0123450001") .bankCode("000014") .build()) .holder(BankAccountCheckHolder.ofBankAccountCheckPersonHolder(BankAccountCheckPersonHolder.builder() .fullName("Maria Oliveira") .build())) .vendorData("payout_20481") .build()); System.out.println(result); - lang: php label: PHP source: |- bank->accountCheck([ 'country' => 'NGA', 'account' => [ 'account_number' => '0123450001', 'bank_code' => '000014', ], 'holder' => [ 'full_name' => 'Maria Oliveira', ], 'vendor_data' => 'payout_20481', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.bank.account_check( country: "NGA", account: { account_number: "0123450001", bank_code: "000014", }, holder: { full_name: "Maria Oliveira", }, vendor_data: "payout_20481" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Bank.AccountCheckAsync(new BankAccountCheckRequest { Country = "NGA", Account = new() { AccountNumber = "0123450001", BankCode = "000014", }, Holder = new() { FullName = "Maria Oliveira", }, VendorData = "payout_20481", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: BankAccountCheckRequest: type: object required: - country - account - holder properties: country: type: string minLength: 3 maxLength: 3 description: >- Le pays du compte, sous forme de code ISO 3166-1 alpha-3, par exemple `NGA`. Les minuscules sont acceptées. example: NGA account: type: object description: >- Le compte tel qu'écrit dans son pays : un `iban`, ou un `account_number` avec le code de banque ou de branche requis par le pays (`sort_code`, `routing_number`, `transit_institution`, `bsb`, `ifsc`, `bank_code` ou `bic`). Le Mexique utilise un `clabe` et l'Argentine un `cbu_cvu`, qui identifient déjà la banque. Un compte d'entreprise ajoute un `registration_id` lorsque le pays le demande. Les espaces, tirets et points sont ignorés. Les clés non utilisées par la vérification du pays sont ignorées ; une clé requise manquante renvoie un `400` mentionnant son nom. properties: iban: type: string maxLength: 64 description: >- L'IBAN, dans un pays qui utilise l'IBAN. Il doit appartenir à `country`. account_number: type: string maxLength: 64 description: >- Le numéro de compte, dans un pays où le compte s'écrit avec un code de banque ou de branche distinct. sort_code: type: string maxLength: 64 description: 'Royaume-Uni : le sort code à 6 chiffres.' routing_number: type: string maxLength: 64 description: 'États-Unis : le numéro de routage ABA à 9 chiffres.' transit_institution: type: string maxLength: 64 description: 'Canada : le numéro de transit et d''institution à 8 chiffres.' bsb: type: string maxLength: 64 description: "Australie\_: le BSB à 6 chiffres." ifsc: type: string maxLength: 64 description: 'Inde : code IFSC à 11 caractères.' bank_code: type: string maxLength: 64 description: >- Le code de la banque, lorsque le pays en nécessite un, par exemple au Nigeria. bic: type: string maxLength: 64 description: >- Le BIC de la banque, lorsque la vérification du pays en demande un. clabe: type: string maxLength: 64 description: 'Mexique : la CLABE à 18 chiffres. Elle indique déjà la banque.' cbu_cvu: type: string maxLength: 64 description: >- Argentine : le CBU ou CVU à 22 chiffres. Il indique déjà la banque. registration_id: type: string maxLength: 64 description: >- Le numéro d'immatriculation d'un compte d'entreprise, lorsque le pays en exige un. additionalProperties: type: string maxLength: 64 example: bank_code: '000014' account_number: '0123450001' holder: $ref: '#/components/schemas/BankAccountCheckHolder' vendor_data: type: string nullable: true description: >- Votre propre référence pour cette vérification, renvoyée sans modification. example: payout_20481 consent: type: boolean default: false description: >- Définir sur `true` lorsque le titulaire du compte a explicitement consenti à cette vérification. Requis dans les pays où la vérification de compte exige ce consentement : sans lui, la vérification est refusée avec une erreur `400` dont le `field` est `consent` et la `reason` est `required`, et rien n'est facturé. Ailleurs, il est facultatif et Didit l'enregistre avec les frais de la vérification lorsque vous l'envoyez. example: true BankAccountCheckResponse: type: object required: - request_id - result - holder_name - account - vendor_data - created_at properties: request_id: type: string format: uuid description: L'identifiant de cette vérification. result: type: string enum: - match - close_match - no_match - cannot_verify description: >- `match` : la banque détient le compte sous le nom que vous avez envoyé. `close_match` : sous un nom proche, par exemple un deuxième prénom manquant ou une faute de frappe. `no_match` : sous un autre nom, ou ce compte n'existe pas. `cannot_verify` : la banque a répondu sans comparer le nom, par exemple pour un compte bloqué ou clôturé. holder_name: type: string nullable: true description: >- Uniquement sur un `close_match`, et uniquement lorsque la banque l'a renvoyé : le nom figurant sur le compte, tel qu'il figure dans les registres de la banque. `null` sinon. account: type: string description: Le compte, masqué sauf ses 4 derniers caractères. vendor_data: type: string nullable: true description: Votre propre référence, telle que vous l'avez envoyée. created_at: type: string format: date-time description: Date et heure d'exécution de la vérification, en UTC. BankAccountCheckError: type: object required: - detail properties: detail: type: string description: Ce qui s'est mal passé, en anglais. code: type: string description: >- Un code stable sur lequel brancher votre logique. Absent sur `401` et `403`. field: type: string description: >- `400` uniquement : le champ du corps à corriger, sous forme de chemin avec points, par exemple `account.sort_code`. reason: type: string enum: - required - length - format - checksum - country_mismatch - rejected description: >- `400` uniquement : raison pour laquelle le champ a été refusé. `required`, `length`, `format`, `checksum` et `country_mismatch` (un IBAN d'un autre pays) sont les propres vérifications de Didit ; `rejected` signifie que la banque a refusé le compte tel qu'envoyé. BankAccountCheckHolder: description: >- Le nom auquel le compte est comparé. Envoyez exactement l'un des deux champs `full_name` ou `business_name`. oneOf: - $ref: '#/components/schemas/BankAccountCheckPersonHolder' - $ref: '#/components/schemas/BankAccountCheckBusinessHolder' BankAccountCheckPersonHolder: type: object description: La personne qui doit détenir le compte. required: - full_name properties: full_name: type: string maxLength: 255 description: Le nom complet de la personne qui doit détenir le compte. example: Maria Oliveira BankAccountCheckBusinessHolder: type: object description: >- L'entreprise qui doit détenir le compte. Vérifie un compte professionnel. required: - business_name properties: business_name: type: string maxLength: 255 description: >- Le nom de l'entreprise qui doit détenir le compte. Vérifie un compte d'entreprise. responses: RateLimitedWrite: description: >- La limite d'écriture partagée de 300 requêtes par minute et par clé API a été dépassée. Respectez l'en-tête `Retry-After` avant de réessayer. content: application/json: schema: type: object required: - detail properties: detail: type: string example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Le token d'accès client-credentials de l'application. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.