Saltar al contingut principal
POST
curl
En producció, la comprovació del compte s’executa a Nigèria, Ghana i Kenya. Un altre país respon amb 404 i code: country_not_covered i no es factura. Més països s’obriran amb el temps, i preus de Verificació bancària mostren sempre el que ofereix cada país avui.
El teu backend envia el nom i el compte, i llegeix el resultat. És la comprovació del compte del pas de Verificació bancària, sense la persona.

Envia el compte com l’escriu el seu país

Alguns països també demanen un bic, i per a un compte d’empresa un registration_id. Els espais, els guions i els punts s’ignoren. Si falta una clau que necessita la comprovació del compte, es retorna un 400 que l’especifica, per exemple "field": "account.bank_code", "reason": "required". Envia holder.full_name per comprovar el compte d’una persona, o holder.business_name per comprovar el d’una empresa.

Envia el consentiment del titular del compte

En alguns països, la comprovació del compte necessita el consentiment explícit del titular del compte abans de cada comprovació. Demana’l dins del teu producte i després envia "consent": true. Sense ell, una comprovació en aquests països es rebutja amb un 400 (field: consent, reason: required) i no es factura. A la resta de països, consent és opcional, i quan l’envies Didit el registra amb el càrrec de la comprovació. Una clau de sandbox demana consentiment en els mateixos països que una clau de producció.

Llegeix el resultat

Facturació i reintents

Cada comprovació a la qual respon el banc es factura una vegada al Preu de la comprovació del compte del país del compte, sigui quin sigui el resultat. Una sol·licitud que rep un error no es factura mai: un cos rebutjat (400), sense crèdit (402), un compte per al qual encara no s’ofereix cap comprovació (404) o un banc que no ha pogut respondre (503). No hi ha clau d’idempotència ni endpoint per consultar una comprovació un cop feta. Una sol·licitud reintentada executa una comprovació nova, amb un request_id nou, i es factura de nou, així que desa la resposta. Didit només guarda el càrrec, amb l’ID de la sol·licitud, el país, el resultat i el compte emmascarat, mai el nom ni el número de compte complet.

Prova-ho al sandbox

Una clau d’API de sandbox no crida cap banc i no es cobra res. Els 4 últims caràcters de l’IBAN, o si no del número de compte, determinen la resposta: Un IBAN, un CLABE i un CBU porten dígits de control: fes servir els valors de sandbox que superen totes les comprovacions de format.

Accés

Autentica’t amb la x-api-key de la teva aplicació, o amb el seu token portador de credencials de client. Una clau d’API amb àmbit necessita accés d’escriptura a les sessions. L’endpoint comparteix el límit d’escriptura de 300 sol·licituds per minut per clau d’API.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json
country
string
requerit

El país del compte, com a codi ISO 3166-1 alpha-3, per exemple NGA. S'admeten minúscules.

Required string length: 3
Exemple:

"NGA"

account
object
requerit

El compte tal com s'escriu al seu país: un iban, o un account_number amb el codi de banc o de sucursal que el país necessita (sort_code, routing_number, transit_institution, bsb, ifsc, bank_code o bic). Mèxic utilitza una clabe i l'Argentina un cbu_cvu, que ja identifiquen el banc. Un compte d'empresa afegeix un registration_id quan el país ho demana. Els espais, guions i punts s'ignoren. Les claus que la comprovació del país no utilitza s'ignoren; una clau que necessita i no rep és un error 400 que n'indica el nom.

Exemple:
holder
object
requerit

El nom amb què es comprova el compte. Envia exactament un dels camps full_name i business_name.

vendor_data
string | null

La teva pròpia referència per a aquesta comprovació, retornada sense canvis.

Exemple:

"payout_20481"

Estableix-ho a true quan el titular del compte hagi donat el consentiment explícit per a aquesta comprovació. Requerit als països on la comprovació de comptes necessita aquest consentiment: sense ell, la comprovació es rebutja amb un 400 en què field és consent i reason és required, i no es factura res. A la resta de països és opcional, i Didit el registra amb el càrrec de la comprovació quan l'envies.

Exemple:

true

Resposta

El banc ha respost. La comprovació es factura, sigui quin sigui el resultat.

request_id
string<uuid>
requerit

L'ID d'aquesta comprovació.

result
enum<string>
requerit

match: el banc té el compte sota el nom que has enviat. close_match: sota un nom proper, per exemple amb un segon nom absent o una errada tipogràfica. no_match: sota un altre nom, o aquest compte no existeix. cannot_verify: el banc ha respost sense comparar el nom, per exemple en un compte bloquejat o tancat.

Opcions disponibles:
match,
close_match,
no_match,
cannot_verify
holder_name
string | null
requerit

Només en cas de close_match, i només quan el banc l'hagi retornat: el nom al compte, tal com el té el banc. Altrament, null.

account
string
requerit

El compte, emmascarat amb els seus últims 4 caràcters.

vendor_data
string | null
requerit

La teva pròpia referència, tal com la vas enviar.

created_at
string<date-time>
requerit

Quan es va executar la comprovació, en UTC.

Darrera modificació el 7 de novembre del 2026