Guías
Inicia sesión en Prometeo

México - AV (v2)

Cobertura del 100% de las cuentas conectadas vía SPEI.

Parámetros de entrada

FormatoInputs
CLABE
  • country_code = "MX" (requerido)
  • account_identifier = Número de CLABE (requerido)
  • owner_name = Nombre asociado a la cuenta (opcional para match_verdict)
  • owner_id = Número de documento asociado a la cuenta (opcional para match_verdict)
  • account_currency = Moneda de la cuenta (opcional para match_verdict)
Local
  • country_code = "MX" (requerido)
  • account_identifier = Número de cuenta en formato local (requerido)
  • bank_code o swift_code = Código de la institución bancaria (requerido)
  • branch_code = Número de sucursal bancaria de la cuenta (requerido)
  • owner_name = Nombre asociado a la cuenta (opcional para match_verdict)
  • owner_id = Número de documento asociado a la cuenta (opcional para match_verdict)
  • account_currency = Moneda de la cuenta (opcional para match_verdict)
Tarjeta de débito
  • country_code = "MX" (requerido)
  • account_identifier = Número de tarjeta de débito (requerido)
  • bank_code o swift_code = Código de la institución bancaria (opcional) (*)
  • owner_name = Nombre asociado a la cuenta (opcional para match_verdict)
  • owner_id = Número de documento asociado a la cuenta (opcional para match_verdict)
  • account_currency = Moneda de la cuenta (opcional para match_verdict)
(*) Puedes enviar el bank_code o el swift_code del banco emisor de la tarjeta para garantizar una mayor tasa de efectividad de validaciones.

Para ver más detalles visita la sección de referencia: Referencia de la API

✅

En México se encuentra disponible únicamente para cuentas en moneda local.


Contenido de la respuesta

ServicioInformación
account_validation
  • Existencia de la cuenta
  • Estado operativo de la cuenta
  • Particularidades asociadas al estado de la cuenta
account_owner_name
  • Nombre asociado a la cuenta
  • Grado de coincidencia (match) con el input ingresado
account_owner_id

  • Número y tipo de documento asociado a la cuenta

  • Grado de coincidencia (match) con el input ingresado

account_currency

  • Moneda asociada a la cuenta

  • Grado de coincidencia (match) con el input ingresado

account_details
  • Número de cuenta en sus diferentes formatos
  • Número de sucursal bancaria de la cuenta
  • Detalles sobre el banco de la cuenta
⚠️

Esta suele ser la respuesta general de la API para este país. Puede haber ocasiones en las que el banco destinatario no proporcione toda la información listada anteriormente. En ese caso, el campo será devuelto en blanco.


Códigos y subcódigos de respuestas para MX

HTTP codeSub-codeDescripción
200MX000"Cuenta reportada como activa"
200MX002"Cuenta identificada, con posibles limitaciones para recibir transferencias"
200MX004"No hay coincidencia para la cuenta proporcionada"
200MX008"Cuenta reportada como cerrada"
200MX015"Cuenta reportada como bloqueada"
200MX016"Cuenta identificada, sin estado operacional reportado por divisa no soportada"
200MX017"No hay coincidencia para el número de tarjeta proporcionado"
422MX032"El número de cuenta proporcionado no cumple con el formato requerido. Debe contener solo dígitos"
422MX037"El número de tarjeta de débito proporcionado no supera el algoritmo de validación de la tarjeta de débito"
422MX038"El valor proporcionado no corresponde a un formato válido. La CLABE debe tener 18 dígitos, la tarjeta de débito debe tener 16 dígitos y el formato local debe tener menos de 14 dígitos"
422MX039"El número de cuenta proporcionado no supera el algoritmo de validación de CLABE"
400MX999"El banco consultado no existe o no está soportado"
503MX503"El BIN de la tarjeta no puede ser validado en este momento. Por favor, envíe el código de banco en el parámetro bank_code"

Códigos y subcódigos de respuestas generales

HTTP codeSub-codeDescripción
200XX000"Información no disponible"
202XX202"Validación pendiente"
400XX400"Parámetro faltante: XXXX"
400XX400"Parámetro inválido: XXXX"
401XX401"API key faltante"
401XX401"API key inválida"
403XX403"La funcionalidad solicitada (XXX) no está habilitada para esta API key"
403XX403"El servicio solicitado (XXX) no está habilitado para esta API key"
403XX403"El país solicitado (XX) no está habilitado para esta API key"
403XX403"Validación no permitida para este identificador"
500XX500"Error interno"
503XX503"Error de comunicación"

Datos mock para pruebas en Sandbox

CasoDatos
Cuenta válida (CLABE)"country_code": "MX"
"account_identifier": "999000000000000001"

"owner_name": "José Hernández"
"owner_id": "HEGJ800101A12"
"account_currency": "MXN"
Cuenta no encontrada (CLABE)"country_code": "MX"
"account_identifier": "999000000000000014"
Cuenta cerrada (CLABE)"country_code": "MX"
"account_identifier": "999000000000000027"
Cuenta bloqueada (CLABE)"country_code": "MX"
"account_identifier": "999000000000000030"
Cuenta en otra divisa (CLABE)"country_code": "MX"
"account_identifier": "999000000000000043"
Cuenta con limitaciones (CLABE)"country_code": "MX"
"account_identifier": "999000000000000056"
Cuenta válida (Debit card)"country_code": "MX"
"account_identifier": "9999128424212135"
"bank_code": "999" o "swift_code": "PROMMX99XXX"

"owner_name": "José Hernández"
"owner_id": "HEGJ800101A12"
"account_currency": "MXN"
Cuenta no encontrada (Debit card)"country_code": "MX"
"account_identifier": "9999123456789019"
"bank_code": "999" o "swift_code": "PROMMX99XXX"
Cuenta sin coincidencia (Debit card)"country_code": "MX"
"account_identifier": "9999120000000000"
"bank_code": "999" o "swift_code": "PROMMX99XXX"
Cuenta válida (Local)"country_code": "MX"
"account_identifier": "0000000000"
"bank_code": "999" o "swift_code": "PROMMX99XXX"
"branch_code": "000"

"owner_name": "José Hernández"
"owner_id": "HEGJ800101A12"
"account_currency": "MXN"
Cuenta no encontrada (Local)"country_code": "MX"
"account_identifier": "000000001"
"bank_code": "999" o "swift_code": "PROMMX99XXX"
"branch_code": "000"