Servicios de la API
La API provee cuatro tipos de servicios:
Servicio para obtener token de sesión: Este es el primer servicio a invocar cada vez que se desee acceder a los servicios de la API. Permite obtener un token temporal que se debe incluir en todos los servicios a utilizar durante cada sesión.Ver especificación técnica del servicio de token de sesión.
Servicio de bitácora: Permite conocer la última fecha de actualización de las diferentes tablas y catálogos en la base de datos del Banco de México. Esto es de utilidad para evitar realizar consultas de información que no se ha modificado en la base de datos. Ver Especificación técnica del servicio de bitácora.
Servicio de catálogos: Permiten obtener los catálogos necesarios para interpretar los valores de aquellos campos que toman valores de catálogo. Por ejemplo, el campo “tipo de instrumento†que aparece en la tabla de productos generales, puede tomar las claves que se muestran en el siguiente catálogo:
Clave | Tipo de instrumento |
---|---|
2 | Productos de crédito hipotecario |
5 | Productos de crédito revolvente (tarjetas de crédito) |
6 | Productos de crédito no revolvente (automotriz, nómina y personal) |
Ver Especificación técnica de servicio de catálogos.
Servicios de características y costos de productos: Permite descargar las diferentes tablas que contienen información de las características y los costos de los productos de crédito. La información de cada tipo de crédito se almacena en diferentes tablas dependiendo del tipo de información de que se trate. Es decir, se tienen tablas para cada tipo de información, entre otras, de características generales del producto, de requisitos de elegibilidad, de tasa de interés y CAT, de comisiones, de seguros, de beneficios (en el caso de tarjetas de crédito). Estos servicios de la API permiten obtener la información almacenada en cada una de estas tablas. Para poder asociar la información de las Distintas tablas a un producto específico, se deben usar los identificadores de producto, subproducto y operativos que se incluyen en cada tabla.
Ver Especificación técnica de servicios de características y costos de productos.
Especificación técnica del servicio de token de sesión
Este servicio proporciona un token de sesión que el desarrollador deberá utilizar en todas las consultas que realice durante la sesión. La validez del token es temporal (ver detalle en la página de Administración de la API), en caso de que expire durante la sesión se debe obtener uno nuevo.
URL:
https://comparador.banxico.org.mx/ComparadorCrediticio/api/auth
Método:
POST
Headers:
Nombre | Descripción |
---|---|
BMX-Auth | El valor del header se formará por la cadena de caracteres concatenados del identificador y la llave asignados, de la siguiente forma: clientId:clientSecret, esta cadena de caracteres deberá usar una codificación Base64 |
Se obtiene el access token que debe ser enviado como parámetro para consultar los diferentes servicios.
Respuesta Error | Elementos que contiene una respuesta de una peticion procesada con errores. |
---|---|
success | false Indica si la peticion fue procesada correctamente. |
error | Identificador del error |
error_description | descripción del error |
Respuesta correcta | Elementos que contiene una respuesta de una petición procesada sin errores. |
success | true Indica si la peticion fue procesada correctamente. |
access_token | Token que sera enviado como parámetro al consumir los diferentes servicios. |
Especificación técnica del servicio de bitácora
Este servicio proporciona la fecha de la última actualización de los diferentes catálogos y tablas disponibles a través de los servicios de esta API. El desarrollador deberá utilizar este servicio para determinar si requiere actualizar alguno de los catálogos o tablas previamente obtenidos.
URL:
https://comparador.banxico.org/api/estatus
Método:
POST
Parámetros de entrada:
Parámetros obligatorios.
Nombre | Descripción |
---|---|
access_token | En cada petición se debe enviar el token de sesión que se generó previamente. |
Se obtienen las fechas en las que cada catálogo y tabla se modificaron por última vez.
Status | Resultado obtenido al realizar la llamada del servicio |
---|---|
errorMessage | Mensaje |
errorId | Identificador único |
actualizaciones | Listado de elementos que contienen los siguientes pares de valores: |
nombre | Nombre del servicio o catálogo |
fechaActualizacion | Fecha en la que se actualizó el servicio o catálogo. |
Especificación técnica del servicios de catálogos
Este servicio proporciona el contenido de los diferentes catálogos asociados a diversos campos en las tablas de características y costos de productos. El servicio requiere de un parámetro de entrada que corresponde al nombre del catálogo que se desea obtener.
El Apéndice A en esta sección lista los nombres de los catálogos disponibles y los tipos de productos a los que aplica, también pueden ser consultados a través del endpoint https://comparador.banxico.org.mx/ComparadorCrediticio/api/catalogos/disponibles
URL:
https://comparador.banxico.org.mx/ComparadorCrediticio/api/catalogos
Método:
POST
Parámetros de entrada:
Parámetros obligatorios.
Nombre | Descripción |
---|---|
access_token | En cada petición se debe enviar el token de sesión que se generó previamente. |
catalogName | Nombre del catálogo que se desea obtener. |
Nombre | Resultado obtenido al realizar la llamada del servicio |
---|---|
catalogContent | Listado de la información del catálogo que está en la base de datos |
descripción | Valor relacionado al identificador que se proporciona |
clave | Identificador único que tiene el valor del catálogo en la base de datos de Banxico |
Apéndice A:
Nombre | Descripción |
---|---|
ENTIDADESFINANCIERAS | Listado de entidades financieras para las que se tiene información. |
TIPOINSTRUMENTO |
Listado de los tipos de instrumentos financieros. |
DESTINOCREDITOREVOLVENTE |
Listado de destinos para interpretar los destinos de los productos de crédito revolvente. |
DESTINOCREDITONOREVOLVENTE |
Listado de destinos para interpretar los destinos de los productos de crédito no revolvente. |
DESTINOCREDITOHIPOTECARIO |
Listado de destinos para interpretar los destinos de los productos de crédito hipotecario. |
ESTABLECIMIENTO |
Listado de de tipos de establecimientos. |
TASAREFERENCIAEST |
Indica la tasa de referencia a considerar. |
MARCASAUTOS |
Indica las marcas de autos disponibles. |
BASECOBRO | En este catálogo se tiene la información sobre la base que se hace el cobro de las comisiones. Aplica a todos los tipos de crédito. |
CLASE | En caso de que el producto de crédito revolvente tenga una tarjeta como medio de disposición, indica la clase de dicha tarjeta: básica, clásica, oro o platino. Si el producto de crédito revolvente no es una tarjeta de crédito se debe dejar vacío. Aplica a los tipos de crédito revolvente. |
GARANTIACNR | Indica el tipo de garantía en caso de que aplique. Para créditos hipotecarios se debe seleccionar si la garantía es la vivienda (hipotecaria) o el saldo de la subcuenta de vivienda. Para créditos revolventes y no revolventes, de no existir garantía, seleccionar la opción “Sin garantía.â€Aplica a los créditos no revolventes. |
GARANTIACR | Indica el tipo de garantía en caso de que aplique. De no existir garantía, no es necesario usar valor alguno. Aplica a los créditos revolventes. |
GARANTIAHIPOTECARIO | Indica el tipo de garantía en caso de que aplique. Para créditos hipotecarios se debe seleccionar si la garantía es la vivienda (hipotecaria) o el saldo de la subcuenta de vivienda. Aplica a los créditos hipotecario. |
MEDIODISPOSICIONCNR | Indica los diferentes medios a través de los cuales se puede disponer de los fondos o crédito disponible. Aplica a los créditos no revolventes. |
MEDIODISPOSICIONCR | Indica los diferentes medios a través de los cuales se puede disponer de los fondos o crédito disponible. Aplica a los créditos revolventes. |
MONEDA | Unidad de cuenta en la que se registran los saldos del producto. Aplica a crédito revolvente, crédito no revolvente y crédito hipotecario. |
OPERADORES | Indica el tipo de vivienda que se debe de tener para los distintos productos que se tienen. Aplicable a crédito hipotecario. |
PERIODICIDADPAGO | Indica la periodicidad con la que se debe pagar el crédito. Aplica a crédito no revolvente. |
PERSONALIDADJURIDICA | Muestra los perfiles jurídicos que pueden tener los clientes que soliciten préstamos. Aplica para todos los créditos. |
PLAZOTIPOPERI | Periodicidad en la que los usuarios pueden realizar el pago de sus préstamos. Aplica para todos los créditos. |
PREVTIPOEVENTO | Tipo de eventos en los que se ofrecen preventas de boletos. Aplica a créditos revolventes. |
PROGRAMAS | Indica si el crédito hipotecario se puede contratar con algún tipo de programa de ONAVIs. Aplicable a crédito hipotecario. |
PUBLICO_REVOLVENTE_NO_REVOLVENTE_HIPOTECARIO | Indica si la persona debe ser cliente, cliente distinguido (pertenecer a un programa de cliente diferenciado), o no necesita ser cliente actual de la institución para acceder al producto. Aplica para créditos revolventes, no revolventes e hipotecarios. |
PUNTOSFORMAUTILIZAR | Indica la forma en que se podrán utilizar los puntos que se obtengan en los programas de lealtad que ofrecen las distintas instituciones bancarias. Aplica para créditos revolventes. |
NOMBREPROGRAMAPUNTOS | Indica el nombre del programa de lealtad que ofrecen las distintas instituciones bancarias. Aplica para créditos revolventes. |
TASA | Indica si la tasa de interés es fija, variable, mixta, creciente o decreciente. Aplicable a crédito revolvente, no revolvente e hipotecario. |
MODOCALCTASA | Indica el modo de uso de la tasa de referencia. Aplicable a crédito revolvente, no revolvente e hipotecario. |
TIPOAUTO | Indica el tipo de auto que se ofrece. Aplicable a créditos automotrices. |
TIPOBIENCNR | Identifica el tipo de bien que se puede adquirir con el crédito. Aplicable a crédito no revolvente. |
TIPOCOMISIONCORRESPONSAL | Indica el tipo de comisión corresponsal que se cobrará. Aplicable a crédito revolvente, no revolvente e hipotecario. |
TIPOCOMISIONPENALIZACIONAUTO | Indica el tipo de comisión de penalización que se cobrará. Aplicable a crédito automotriz. |
TIPOCOMISIONPENALIZACIONCR | Indica el tipo de comisión de penalización que se cobrará. Aplicable a crédito no revolvente. |
TIPOCOMISIONPENALIZACIONHIPOTECARIO | Indica el tipo de comisión de penalización que se cobrará. Aplicable a crédito hipotecario. |
TIPOCOMISIONUSOAUTO | Indica le tipo de comisión de uso que se cobrará. Aplica a crédito automotriz. |
TIPOCOMISIONUSOCR | Indica le tipo de comisión de uso que se cobrará. Aplica a crédito revolvente. |
TIPOCOMISIONUSOHIPOTECARIO | Indica le tipo de comisión de uso que se cobrará. Aplica a crédito hipotecario. |
TIPOCORRESPONSALES | Indica las instituciones que pueden aceptar pagos a nombres de instituciones bancarias. Aplicable a crédito revolvente y no revolvente. |
TIPOPERIODOTIEMPROM | Indica la interpretación del tiempo promedio de aprobación. Aplicable a crédito revolvente, no revolvente e hipotecario. |
TIPOPERIODO | Indica el periodo en el que se podrá realizar pagos de un producto contratado. Aplicable a crédito revolvente, no revolvente e hipotecario. |
TIPOPROGRAMA | Indica si el crédito hipotecario se puede contratar con algún tipo de programa de ONAVIs. Reportar “Sin programa†si el crédito no se puede contratar con ayuda de ONAVIs. Aplicable a crédito hipotecario. |
TIPOSEGUROAUTO | Indica los seguros que se pueden contratar en un crédito automotriz. Aplica a crédito automotriz. |
TIPOSEGUROCR | Indica los seguros que se pueden contratar en un crédito revolvente. Aplica a crédito revolvente. |
TIPOSEGUROHIPOTECARIO | Indica los seguros que se pueden contratar en un crédito hipotecario. Aplica a crédito hipotecario. |
TIPOVALOR | Indica la forma en que se va a calcular el valor del producto. Aplicable a crédito revolvente, no revolvente e hipotecario. |
TIPOVIVIENDA | Indica el tipo de vivienda que se debe de tener para los distintos productos que se tienen. Aplicable a crédito hipotecario. |
Servicios Generales
Con estos servicios, los desarrolladores podrán obtener la lista de productos del tipo de instrumento especificado que están vigentes en la fecha proporcionada y sus características de elegibilidad.
Servicios de Crédito Hipotecario
En esta sección se listan los servicios que se deberán de utilizar únicamente para generar un comparador de crédito hipotecario.
Servicios de Tarjeta de Crédito
En esta sección se listan los servicios que se deberán de utilizar únicamente para generar un comparador de tarjetas de crédito.
Servicios de Crédito Automotriz
En esta sección se listan los servicios que se deberán utilizar al desarrollar un comparador de créditos automotrices.
Servicios de Crédito de Nómina
En esta sección se listan los servicios que se deberán utilizar al desarrollar un comparador de créditos de nómina.