Passer au contenu principal
POST
curl
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 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 de l’étape Vérification bancaire, sans la personne.

Envoyez le compte selon la forme utilisée par son pays

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

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 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 : Un IBAN, un CLABE et un CBU comportent des chiffres de contrôle : utilisez les valeurs 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.

Autorisations

x-api-key
string
header
requis

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.

Corps

application/json
country
string
requis

Le pays du compte, sous forme de code ISO 3166-1 alpha-3, par exemple NGA. Les minuscules sont acceptées.

Required string length: 3
Exemple:

"NGA"

account
object
requis

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.

Exemple:
holder
object
requis

Le nom auquel le compte est comparé. Envoyez exactement l'un des deux champs full_name ou business_name.

vendor_data
string | null

Votre propre référence pour cette vérification, renvoyée sans modification.

Exemple:

"payout_20481"

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.

Exemple:

true

Réponse

La banque a répondu. La vérification est facturée, quel que soit le résultat.

request_id
string<uuid>
requis

L'identifiant de cette vérification.

result
enum<string>
requis

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

Options disponibles:
match,
close_match,
no_match,
cannot_verify
holder_name
string | null
requis

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
string
requis

Le compte, masqué sauf ses 4 derniers caractères.

vendor_data
string | null
requis

Votre propre référence, telle que vous l'avez envoyée.

created_at
string<date-time>
requis

Date et heure d'exécution de la vérification, en UTC.

Dernière modification le 7 novembre 2026