BANXICO5 tokensPOST

Validación de cuenta bancaria

Valida que una cuenta CLABE exista y esté activa realizando un micro-depósito de verificación (penny check) vía SPEI, y devuelve los datos del titular registrados en el banco receptor. Es una consulta asíncrona: la validación tarda mientras se confirma la transferencia.

Endpoint

POSThttps://api.datosnonstop.com/v1/banxico/validacion-cuenta

Parámetros

json

{
  "clabe": "646180157000000004"
}

ParámetroTipoRequeridoDescripción

clabestringSíCLABE interbancaria de 18 dígitos de la cuenta a validar.

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.datosnonstop.com/v1/banxico/validacion-cuenta \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"clabe":"646180157000000004"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Consulta asíncrona

Esta consulta es asíncrona: el POST no devuelve el resultado de inmediato, sino un acuse 202 Accepted con un id y status: "pending". El resultado final llega después; puedes obtenerlo de dos formas.

Respuesta inicial (202)

JSON

202 Accepted

{
  "id": "64821d23824123766beac2be",
  "status": "pending",
  "clabe": "646180157000000004"
}

Opción 1 — Consultar por id (polling)

GEThttps://api.datosnonstop.com/v1/banxico/validacion-cuenta/{id}

Consulta este endpoint con el id que te devolvió el POST. Mientras el resultado no está listo responde status: "pending"; cuando termina, devuelve el resultado final (ver Respuesta).

Opción 2 — Callback

Envía el header x-callback-url en tu POST con la URL donde quieres recibir el resultado (opcionalmente x-callback-token para verificar el origen del aviso). Cuando el resultado esté listo, Datos Non Stop hará un POST a esa URL con el resultado final:

json

{
  "id": "64821d23824123766beac2be",
  "status": "found",
  "clabe": "646180157000000004",
  "valida": true,
  "titular": "JUAN PEREZ LOPEZ",
  "bancoReceptor": "STP",
  "cuenta": "646180157000000004",
  "rfc": "PELJ900101AB1",
  "curp": "PELJ900101HDFRPN01"
}

Resultado final

JSON

200 OK

{
  "id": "64821d23824123766beac2be",
  "status": "found",
  "clabe": "646180157000000004",
  "valida": true,
  "titular": "JUAN PEREZ LOPEZ",
  "bancoReceptor": "STP",
  "cuenta": "646180157000000004",
  "rfc": "PELJ900101AB1",
  "curp": "PELJ900101HDFRPN01"
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "clabe"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

clabestringCLABE interbancaria de 18 dígitos de la cuenta a validar.

Campos de respuesta

CampoTipoDescripción

idstringIdentificador de la consulta. Úsalo para consultar el resultado por polling o para correlacionar el callback.

statusstringEstado de la consulta. Ver catálogo Status.

clabestringCLABE consultada.

validabooleantrue si la cuenta existe y puede recibir transferencias; false en caso contrario.

titularstringNombre del titular registrado en el banco receptor. Solo cuando valida es true.

bancoReceptorstringBanco receptor asociado a la CLABE. Solo cuando valida es true.

cuentastringCuenta validada. Solo cuando valida es true.

rfcstringRFC del titular registrado en el banco. Solo cuando valida es true y el banco lo reporta.

curpstringCURP del titular registrado en el banco. Solo cuando valida es true y el banco lo reporta.

motivostringMotivo por el que la cuenta no es válida. Solo cuando valida es false.

messagestringDetalle del motivo cuando status es not_found. Solo en respuestas not_found.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción

pendingLa consulta se recibió y está en proceso (se está confirmando el micro-depósito). Vuelve a consultar por id o espera el callback.

foundLa validación terminó. Revisa el campo valida (true/false) para el resultado.

not_foundNo se pudo completar la validación con los datos enviados. La respuesta incluye el campo message.

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/banxico/validacion-cuenta

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl -X POST https://sandbox.api.datosnonstop.com/v1/banxico/validacion-cuenta \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"clabe":"646180157000000004"}'

Casos de prueba

Si envías un valor que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 646180157000000004.

CasoCampoclabe

Caso exitoso — Cuenta válidaclabe646180157000000004

Caso exitoso — Cuenta no válidaclabe646180157000000009

Sin tokensclabe000000000000000402

Error internoclabe000000000000000500

Unavailable serviceclabe000000000000000503

Empezar gratis →