Saltar al contenido principal
POST
curl
La verificación bancaria todavía no está habilitada en producción. Mientras no lo esté, este endpoint responde 404 con code: bank_verification_not_available y no puedes añadir el paso de verificación bancaria a un flujo de producción. Esta página describe cómo se comporta el endpoint una vez que esté disponible.
Tu backend envía el nombre y la cuenta, y obtiene el resultado. Es la comprobación de cuenta del paso de verificación bancaria, sin la persona.

Envía la cuenta como se escribe en su país

Algunos países también piden un bic y, para una cuenta de empresa, un registration_id. Los espacios, guiones y puntos se ignoran. Si falta una clave que necesita la comprobación del país, la respuesta es un 400 que la indica, por ejemplo "field": "account.sort_code", "reason": "required". Envía holder.full_name para comprobar la cuenta de una persona, o holder.business_name para comprobar la de una empresa.

Lee el resultado

Facturación y reintentos

Cada comprobación respondida por el banco se factura una vez al precio de la comprobación de cuenta del país de la cuenta, sea cual sea el resultado. Una solicitud que recibe un error nunca se factura: un cuerpo de solicitud rechazado (400), falta de crédito (402), una cuenta para la que aún no se ofrece ninguna comprobación (404) o un banco que no pudo responder (503). No hay clave de idempotencia ni endpoint para volver a consultar una comprobación. Una solicitud reintentada ejecuta una comprobación nueva, con un request_id nuevo, y se factura de nuevo, así que guarda la respuesta. Didit solo guarda el cargo, con el ID de la solicitud, el país, el resultado y la cuenta enmascarada, nunca el nombre ni el número de cuenta completo.

Pruébalo en sandbox

Una clave de API de sandbox no llama a ningún banco y no genera ningún cargo. Los últimos 4 caracteres del IBAN, o en su defecto del número de cuenta, determinan la respuesta: Un IBAN, una CLABE y un CBU llevan dígitos de control: usa los valores de sandbox que superan todas las comprobaciones de formato.

Acceso

Autentícate con la clave de API x-api-key de tu aplicación o con su token bearer de credenciales de cliente. Una clave de API con permisos específicos necesita acceso de escritura a las sesiones. El endpoint comparte el límite de escritura de 300 solicitudes por minuto por clave de API.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json
country
string
requerido

El país de la cuenta, como código ISO 3166-1 alfa-3, por ejemplo GBR. Se aceptan minúsculas.

Required string length: 3
Ejemplo:

"GBR"

account
object
requerido

La cuenta tal como la escribe su país: un iban, o un account_number con el código de banco o de sucursal que necesita el país (sort_code, routing_number, transit_institution, bsb, ifsc, bank_code o bic). México admite una clabe y Argentina un cbu_cvu, que ya identifican el banco. Una cuenta de empresa añade un registration_id cuando el país lo exige. Se ignoran los espacios, guiones y puntos. Se ignoran las claves que la comprobación del país no utiliza; si falta una clave que necesita, se devuelve un 400 que la indica.

Ejemplo:
holder
object
requerido

El nombre con el que se verifica la cuenta. Envía exactamente uno de full_name y business_name.

vendor_data
string | null

Tu propia referencia para esta comprobación, devuelta sin cambios.

Ejemplo:

"payout_20481"

Respuesta

El banco respondió. La comprobación se factura, sea cual sea el resultado.

request_id
string<uuid>
requerido

El ID de esta comprobación.

result
enum<string>
requerido

match: el banco tiene la cuenta registrada con el nombre que enviaste. close_match: con un nombre parecido, por ejemplo, sin el segundo nombre o con una errata. no_match: con otro nombre, o no existe esa cuenta. cannot_verify: el banco respondió sin comparar el nombre, por ejemplo, en una cuenta bloqueada o cerrada.

Opciones disponibles:
match,
close_match,
no_match,
cannot_verify
holder_name
string | null
requerido

Solo en un close_match, y solo cuando el banco lo devolvió: el nombre de la cuenta tal como lo tiene registrado el banco. null en caso contrario.

account
string
requerido

La cuenta, enmascarada salvo sus últimos 4 caracteres.

vendor_data
string | null
requerido

Tu propia referencia, tal como la enviaste.

created_at
string<date-time>
requerido

Cuándo se ejecutó la comprobación, en UTC.

Última modificación el 1 de noviembre de 2026