Documentación de la API de Belvo (1.222.0)
Alcanza nuevas audiencias y convierte más usuarios conectándote fácil y seguramente a sus datos financieros, entendiendo su comportamiento y habilitando pagos instantáneos con finanzas abiertas. A través de nuestra API, puedes acceder a:
Belvo es una API de banca abierta para América Latina que permite a las empresas acceder a información bancaria y fiscal de manera segura y ágil.
A través de nuestra API, puedes acceder a:
- Información Bancaria en Brasil
- Información Laboral en Brasil
- Información Laboral en México
- Información Fiscal en México
- Información Fiscal en Chile
También puedes usar nuestra API para realizar pagos en:
- Brasil
- México
Si deseas la documentación de respuesta en formato Excel o CSV, por favor descárgalos desde nuestro Repositorio Público de GitHub: Diccionarios de Datos de Belvo Open Finance.
Nuestros archivos EXCEL y CSV están adicionalmente localizados en español y portugués (Brasil).
Disponible para:
- 🟢 Agregación y Enriquecimiento
- ⚪️ Iniciación de Pagos
Usa nuestro entorno Sandbox para construir tu integración. Ofrecemos datos ficticios que imitan casos de uso del mundo real, lo que significa que puedes probar todos los endpoints, usar el widget e implementar webhooks, tal como lo harías con datos reales.
Todo lo que necesitas para comenzar con el entorno Sandbox es obtener tus claves API. Realmente recomendamos que comiences creando tu integración en este entorno.
Disponible para:
- 🟢 Agregación y Enriquecimiento
- 🟢 Iniciación de Pagos
Después de haber probado tu integración en el entorno Sandbox y estar listo para ir en vivo, necesitarás solicitar acceso a nuestro entorno de Producción. Después de solicitar acceso, nuestro equipo de ventas se pondrá en contacto contigo para programar una reunión solo para asegurarse de que se cumplan tus necesidades, y luego solo necesitarás pasar por un proceso de certificación con uno de nuestros ingenieros para asegurarte de que tu integración esté funcionando de manera óptima. Para prepararte para la reunión de certificación, solo sigue nuestra lista de verificación de integración.
Una vez que tu integración esté certificada, todo lo que necesitarás hacer es:
- Solicitar claves API de Producción (y cambiar tus claves API de Sandbox en el código por estas nuevas).
- Cambiar la URL base a la que haces solicitudes de
sandbox.belvo.com
aapi.belvo.com
. - Si estás usando webhooks, asegúrate de establecer una URL de Producción para tus webhooks.
Usamos el siguiente código de estado HTTP en la respuesta dependiendo del éxito o fracaso:
Código de Estado | Descripción |
---|---|
200 | ✅ Éxito - El contenido está disponible en el cuerpo de la respuesta. |
201 | ✅ Éxito - El contenido fue creado exitosamente en Belvo. |
204 | ✅ Éxito - No hay contenido para devolver. |
400 | ❌ Error de Solicitud Incorrecta - La solicitud devolvió un error, detalle en el contenido. |
401 | ❌ No Autorizado - Las credenciales de Belvo proporcionadas no son válidas. |
404 | ❌ No Encontrado - El recurso al que intentas acceder no se puede encontrar. |
405 | ❌ Método No Permitido - El método HTTP que estás usando no es aceptado para este recurso. |
408 | ❌ Tiempo de Solicitud Agotado - La solicitud se agotó y fue terminada por el servidor. |
428 | ❌ Se Requiere Token MFA - La institución requirió un token MFA para conectar. |
500 | ❌ Error Interno del Servidor - El detalle del error está disponible en el cuerpo de la respuesta. |
Los errores de la API de Belvo se devuelven en formato JSON. Por ejemplo, un error podría verse así:
[
{
"request_id": "a6e1c493d7a29d91aed4338e6fcf077d",
"message": "Este campo es obligatorio.",
"code": "required",
"field": "link"
}
]
Típicamente, una respuesta de error tendrá los siguientes parámetros:
request_id
: un ID único para la solicitud, debes compartirlo con el equipo de soporte de Belvo para investigaciones.message
: descripción del error en lenguaje humano.code
: un código único para el error. Consulta la tabla a continuación para ver cómo manejar cada código de error.field
(opcional): El campo específico en el cuerpo de la solicitud que tiene un problema.
Cuando necesites ayuda con un error específico, incluye el identificador de solicitud (request_id
) en tu mensaje al equipo de soporte de Belvo. Esto acelerará las investigaciones y te permitirá volver a funcionar en poco tiempo.
Para una lista completa de errores y cómo solucionarlos, por favor consulta nuestro artículo dedicado Manejo de Errores.
Implementa un retroceso exponencial automatizado de hasta cinco reintentos. Recomendamos usar un intervalo base de tres segundos con un factor de dos. Por ejemplo, el primer reintento debe ser después de tres segundos, el segundo reintento después de seis segundos (2 * 3), el tercer reintento después de 12 segundos (2 * 6), el cuarto reintento después de 24 segundos (2 * 12), y el quinto reintento después de 48 segundos (2 * 24).
No debes reintentar hacer solicitudes si recibes una respuesta 40x, ya que esto es un error del cliente.
La única excepción es el error de "Demasiadas Sesiones", ya que significa que tu usuario final está accediendo a la cuenta desde otro navegador al mismo tiempo. En este caso, por favor implementa la misma política de reintentos que con los errores 50x.
En nuestro esquema, puedes ver que un campo ha sido marcado como deprecated
. Esto significa que este campo ya no es mantenido por el equipo de Belvo. Aún puedes recibir datos para este campo dependiendo de la institución, sin embargo, no debes confiar en este campo.
En nuestra especificación de API, verás que algunos parámetros de respuesta tendrán una anotación de required. Según la especificación de OpenAPI, cuando un parámetro de respuesta está marcado como required, esto significa que la clave de respuesta debe ser devuelta. Sin embargo, el valor de ese parámetro de respuesta puede ser null
.
📘 Info
En resumen, cualquier parámetro de respuesta marcado como requerido será devuelto por nuestra API, pero el valor puede ser establecido en null.
https://developers.belvo.com/_mock/es/apis/belvoopenapispec/
https://sandbox.belvo.com/
Institutions
Una institución es una entidad de la que Belvo puede acceder a información. Puede ser una:
- institución bancaria, como Nubank Brasil.
- institución fiscal, como el Servicio de Administración Tributaria (SAT) en México.
- institución de empleo, como el Instituto Mexicano del Seguro Social (IMSS) en México o el Instituto Nacional do Seguro Social (INSS) en Brasil.
Links
Un Link es un conjunto de credenciales asociadas al acceso de un usuario final a una institución. Necesitarás registrar un Link antes de acceder a la información de ese usuario final específico, como los detalles de cuenta o transacciones.
Recomendamos usar el Belvo Hosted Widget para gestionar el proceso de conexión.
Owners
Un owner representa a la persona que tiene acceso a un Link y es el propietario de todas las cuentas dentro del Link.
Puedes usar este endpoint para obtener información útil sobre tu cliente, como:
- su nombre completo
- información de contacto clave
- información sobre el documento de identificación que usaron al abrir la cuenta
Accounts
Una cuenta es la representación de una cuenta bancaria dentro de una institución financiera. Un usuario puede tener una o más cuentas en una institución.
Por ejemplo, un usuario (o enlace) puede tener una cuenta corriente, varias tarjetas de crédito y una cuenta de préstamo.
Consultar la información de la cuenta de un usuario es útil ya que puedes obtener información sobre:
- qué tipos de cuentas tiene el usuario.
- el saldo de cada cuenta (ahorros, cuenta corriente, tarjeta de crédito, préstamo, etc.).
- información detallada sobre sus gastos con tarjeta de crédito.
- la situación actual de cualquier préstamo que puedan tener.
Employments Brazil
Nuestro recurso de empleos para Brasil te permite obtener una vista completa del historial laboral actual de tu usuario y la información salarial.
Para cada usuario, proporcionamos:
- historial laboral (incluyendo ocupaciones y datos del empleador)
- información salarial histórica y actual (por empleador)
En este momento, el recurso de empleos está disponible para:
- 🇧🇷 Brasil (INSS)
Employment Records Mexico
Nuestro recurso de registros de empleo para México te permite obtener una visión completa de las contribuciones actuales al seguro social y el historial laboral de tu usuario.
Con el recurso de registros de empleo de Belvo para México, puedes acceder a información sobre las contribuciones actuales al seguro social y el historial laboral de tu usuario. Para cada usuario, proporcionamos:
- datos personales
- historial laboral
- salario base diario histórico y actual
- ¡y más!
En este momento, el recurso de registros de empleo está disponible para:
- 🇲🇽 México (IMSS)
- 🇲🇽 México (ISSSTE)
Current Employments Mexico
El recurso de Empleos Actuales proporciona acceso en tiempo real al estado de empleo actual de individuos en México. Este recurso ofrece información detallada sobre si una persona está actualmente empleada o desempleada, junto con sus registros de empleo activos.
Incomes
Utiliza el endpoint de Incomes para obtener información sobre las fuentes de ingresos de una cuenta en los últimos 365 días. Este endpoint es particularmente útil cuando deseas verificar los ingresos de una persona.
📘 Información
El recurso de incomes está solo disponible para cuentas de Checking y Savings asociadas con enlaces bancarios.
Recurring Expenses
La API de Gastos Recurrentes de Belvo te permite identificar los pagos regulares de un usuario para servicios de suscripción, como Netflix o membresías de gimnasio, así como pagos de servicios públicos, como facturas de electricidad o teléfono. Devolvemos información de hasta 365 días.
📘 Info
El recurso de gastos recurrentes está solo disponible para cuentas de Cheques, Ahorros y Tarjetas de Crédito asociadas con enlaces bancarios.
Solicitud
▶️ Uso
Con el método List Risk Insights, puedes:
- Listar las perspectivas de riesgo relacionadas con un
link.id
específico (usando el parámetro de consultalink
). - Obtener los detalles de un
risk-insight.id
específico (usando el parámetro de consultaid
). - [No Recomendado] Listar todas las perspectivas de riesgo relacionadas con tu cuenta de Belvo (sin usar ningún parámetro de consulta).
📖 Paginación
Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta page_size
para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta page
para navegar a través de los resultados. Para más detalles sobre cómo navegar por las respuestas paginadas de Belvo, consulta nuestro artículo Consejos de Paginación.
🔦 Filtrado de Respuestas
Consulta la lista de campos a continuación para ver los campos por los que puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrado de respuestas.
El link.id
por el que deseas filtrar.
ℹ️ Recomendamos encarecidamente añadir el filtro link.id
para mejorar tu rendimiento.
Indica cuántos resultados devolver por página. Por defecto, devolvemos 100 resultados por página.
ℹ️ El número mínimo de resultados devueltos por página es 1 y el máximo es 1000. Si introduces un valor mayor que 1000, nuestra API usará por defecto el valor máximo (1000).
Un número de página dentro del conjunto de resultados paginados.
Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.
Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.
Devuelve resultados solo para estos link.id
s.
El account.id
por el que deseas filtrar.
ℹ️ Recomendamos encarecidamente agregar filtros de link.id
o account.id
para mejorar tu rendimiento.
Devuelve resultados solo para estos account.id
s.
Devuelve información solo para este recurso id
.
- Mock server
https://developers.belvo.com/_mock/es/apis/belvoopenapispec/api/risk-insights/
- Sandbox
https://sandbox.belvo.com/api/risk-insights/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://developers.belvo.com/_mock/es/apis/belvoopenapispec/api/risk-insights/?link=8848bd0c-9c7e-4f53-a732-ec896b11d4c4&page_size=100&page=1&omit=string&fields=string&link__in=5722d0ba-69d7-42dc-8ff5-33767b83c5d6&account=8848bd0c-9c7e-4f53-a732-ec896b11d4c4&account__in=85b77707-90ef-46fd-9059-5a757f24247a&id=24ccab1d-3a86-4136-a6eb-e04bf52b356f&id__in=6b3dea0f-be29-49d1-aabe-1a6d588642e6'
De acuerdo
La URL a la siguiente página de resultados. Cada página consta de hasta 100 elementos. Si no hay suficientes resultados para una página adicional, el valor es null
.
En nuestro ejemplo de documentación, usamos {endpoint}
como un valor de marcador de posición. En producción, este valor será reemplazado por el endpoint real que estás utilizando actualmente (por ejemplo, accounts
o owners
).
La URL a la página anterior de resultados. Si no hay una página anterior, el valor es null
.
{ "count": 130, "next": "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2", "previous": null, "results": [ { … } ] }
Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.
Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.
El link.id
para el que deseas recuperar información.
El token MFA generado por la institución que se requiere para continuar una sesión.
- Mock server
https://developers.belvo.com/_mock/es/apis/belvoopenapispec/api/risk-insights/
- Sandbox
https://sandbox.belvo.com/api/risk-insights/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
-u <username>:<password> \
'https://developers.belvo.com/_mock/es/apis/belvoopenapispec/api/risk-insights/?omit=string&fields=string' \
-H 'Content-Type: application/json' \
-d '{
"link": "c81a1dea-6dd6-4999-8b9f-541ee8197058",
"token": "1234ab",
"save_data": true
}'
Ok (cuando save_data=false)
Identificador único de Belvo para el elemento actual.
El link.id
al que pertenecen los datos.
La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
Una matriz de números de cuenta generados por Belvo (UUIDs) que se utilizaron durante el análisis de perspectivas de riesgo. Si no se encontraron cuentas, devolvemos una matriz vacía.
Agregue detalles sobre los activos utilizados en el análisis de percepción de riesgos. Para las métricas de activos, solo consideramos cuentas corrientes y de ahorros.
Las métricas de activos pueden proporcionar una instantánea de la riqueza y los activos líquidos de su usuario, indicando cómo gestionan su riqueza y su estado financiero actual.
Una matriz de instituciones de las cuales se recuperó información de la cuenta para el usuario.
Nota: Para la mayoría de los casos de uso, esta matriz solo devolverá un elemento.
El número total de cuentas encontradas para el usuario.
El número total de cuentas corrientes encontradas para el usuario.
El número total de cuentas de ahorro encontradas para el usuario.
El saldo total de cierre de todas las cuentas corrientes.
Métricas agregadas calculadas en base a las cuentas de tarjetas de crédito del usuario.
Las métricas de tarjetas de crédito ilustran los hábitos de un cliente con sus tarjetas de crédito, revelando cuántas cuentas de tarjetas de crédito tiene un cliente, su límite de crédito total, cuánto de ese límite está utilizando y la tasa de utilización de su límite de crédito.
Número de cuentas de tarjetas de crédito asociadas al usuario.
Suma total de los límites de todas las tarjetas de crédito.
Suma total de todo el crédito utilizado.
Métricas agregadas calculadas en base a las cuentas de préstamo del usuario y las cuentas corrientes que tienen sobregiro.
Las métricas de préstamos ayudan a comprender el comportamiento de préstamo y reembolso de un cliente, lo que puede ayudar a evaluar su capacidad para asumir crédito adicional y los posibles riesgos de incumplimiento.
El número de cuentas de préstamo asociadas con el usuario.
Suma total del principal de todas las cuentas de préstamo del usuario.
Suma total del principal pendiente para todas las cuentas de préstamo del usuario.
Suma total de los pagos mensuales de todas las cuentas de préstamo del usuario.
El porcentaje del límite del préstamo utilizado.
El límite total de sobregiro de todas las cuentas corrientes y de ahorro.
Métricas de balance calculadas en base a los saldos del usuario de las cuentas corrientes y de ahorros.
El saldo de todas las cuentas en el momento collected_at
.
El saldo mínimo en los últimos tres días.
El saldo mínimo en los últimos tres meses.
El saldo mínimo en los últimos seis meses.
El saldo mínimo en los últimos doce meses.
El saldo medio en los últimos tres días.
El saldo medio en los últimos tres meses.
El saldo medio en los últimos seis meses.
El saldo medio en los últimos doce meses.
El saldo máximo en los últimos tres días.
El saldo máximo en los últimos tres meses.
El saldo máximo en los últimos seis meses.
El saldo máximo en los últimos doce meses.
La desviación estándar del balance en los últimos tres días.
La desviación estándar del balance en la última semana.
La desviación estándar del balance en el último mes.
La desviación estándar del balance en los últimos tres meses.
La desviación estándar del saldo en los últimos seis meses.
La desviación estándar del saldo en los últimos doce meses.
La tendencia del saldo del usuario en los últimos tres días.
La tendencia del saldo del usuario en la última semana.
La tendencia del saldo del usuario en el último mes.
La tendencia del saldo del usuario en los últimos tres meses.
La tendencia del saldo del usuario en los últimos seis meses.
La tendencia del saldo del usuario en los últimos doce meses.
El número de días en los que el saldo total de la cuenta es menor o igual a 0 en los últimos tres días.
El número de días en los que el saldo total de la cuenta es menor o igual a 0 en la última semana.
El número de días en que el saldo total de la cuenta es menor o igual a 0 en el último mes.
El número de días en los que el saldo total de la cuenta es menor o igual a 0 en los últimos tres meses.
El número de días en los que el saldo total de la cuenta es menor o igual a 0 en los últimos seis meses.
El número de días en que el saldo total de la cuenta es menor o igual a 0 en los últimos doce meses.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_3d
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_1w
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_1m
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_3m
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_6m
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_12m
.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en los últimos tres días.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en la última semana.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en el último mes.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en los últimos tres meses.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en los últimos seis meses.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en los últimos doce meses.
Métricas agregadas calculadas basadas en las transacciones del usuario de cuentas corrientes, de ahorros, de tarjetas de crédito y de préstamos.
ℹ️ Nota
Si no hay suficientes datos transaccionales para un período dado, devolvemos
null
para los campos calculados y0
para los campos basados en conteo. Por ejemplo, si la cuenta solo ha estado abierta durante cinco días (o si has proporcionado datos solo para cinco días), devolvemos valores para_3d
,_1w
y_1m
, sin embargo:
mean_num_transactions_3m
devolveránull
ya que no hay datos para los meses dos y tres (campo calculado).num_transactions_3m
devolverá0
ya que no hay datos para los meses dos y tres (campo basado en conteo).
El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos tres días (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo de la última semana (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo del último mes (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos tres meses (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos seis meses (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos doce meses (entrantes y salientes).
El número máximo de transacciones de los últimos tres días.
El número máximo de transacciones de la última semana.
El número máximo de transacciones del último mes.
El número máximo de transacciones de los últimos tres meses.
El número máximo de transacciones de los últimos seis meses.
El número máximo de transacciones de los últimos doce meses.
El número medio de transacciones de los últimos tres días.
El número medio de transacciones de la última semana.
El número medio de transacciones del último mes.
El número medio de transacciones de los últimos tres meses.
El número medio de transacciones de los últimos seis meses.
El número medio de transacciones de los últimos doce meses.
El número total de transacciones de entrada en los últimos tres días.
El número total de transacciones de entrada de la última semana.
El número total de transacciones de entrada del mes pasado.
El número total de transacciones de entrada en los últimos tres meses.
El número total de transacciones de entrada en los últimos seis meses.
El número total de transacciones de entrada en los últimos doce meses.
El número máximo de transacciones de entrada de los últimos tres días.
El número máximo de transacciones de entrada de la última semana.
El número máximo de transacciones de entrada del mes pasado.
El número máximo de transacciones de entrada en los últimos tres meses.
El número máximo de transacciones de entrada en los últimos seis meses.
El número máximo de transacciones de entrada en los últimos doce meses.
El número medio de transacciones de entrada de los últimos tres días.
El número medio de transacciones de entrada de la última semana.
El número medio de transacciones de entrada del mes pasado.
El número promedio de transacciones de entrada durante los últimos tres meses.
El número medio de transacciones de entrada durante los últimos seis meses.
El número medio de transacciones de entrada durante los últimos doce meses.
La suma total de todas las transacciones de entrada de los últimos tres días.
La suma total de todas las transacciones de entrada de la última semana.
La suma total de todas las transacciones de entrada del mes pasado.
La suma total de todas las transacciones de entrada de los últimos tres meses.
La suma total de todas las transacciones de entrada de los últimos seis meses.
La suma total de todas las transacciones de entrada de los últimos doce meses.
La transacción de entrada de mayor valor en los últimos tres días.
La transacción de entrada de mayor valor en la última semana.
La transacción de entrada de mayor valor en el último mes.
La transacción de entrada de mayor valor en los últimos tres meses.
La transacción de entrada de mayor valor en los últimos seis meses.
La transacción de entrada de mayor valor en los últimos doce meses.
El valor medio entrante de todas las transacciones en los últimos tres días.
El valor medio entrante de todas las transacciones de la última semana.
El valor medio entrante de todas las transacciones del mes pasado.
El valor medio entrante de todas las transacciones en los últimos tres meses.
El valor medio entrante de todas las transacciones en los últimos seis meses.
El valor medio entrante de todas las transacciones en los últimos doce meses.
Al número total de transacciones de salida en los últimos tres días.
Al número total de transacciones de salida en la última semana.
Al total de transacciones de salida en el último mes.
Al número total de transacciones de salida en los últimos tres meses.
Al número total de transacciones de salida en los últimos seis meses.
Al número total de transacciones de salida en los últimos doce meses.
El número máximo de transacciones de salida de los últimos tres días.
El número máximo de transacciones de salida de la última semana.
El número máximo de transacciones de salida del último mes.
El número máximo de transacciones de salida en los últimos tres meses.
El número máximo de transacciones de salida en los últimos seis meses.
El número máximo de transacciones de salida en los últimos doce meses.
El número medio de transacciones de salida de los últimos tres días.
El número medio de transacciones de salida de la última semana.
El número medio de transacciones de salida del último mes.
El número medio de transacciones de salida durante los últimos tres meses.
El número medio de transacciones de salida durante los últimos seis meses.
El número medio de transacciones de salida durante los últimos doce meses.
La suma total de todas las transacciones de salida de los últimos tres días.
La suma total de todas las transacciones de salida de la última semana.
La suma total de todas las transacciones de salida del mes pasado.
La suma total de todas las transacciones de salida de los últimos tres meses.
La suma total de todas las transacciones de salida de los últimos seis meses.
La suma total de todas las transacciones de salida de los últimos doce meses.
La transacción de salida de mayor valor en los últimos tres días.
La transacción de salida de mayor valor en la última semana.
La transacción de salida de mayor valor en el último mes.
La transacción de salida de mayor valor en los últimos tres meses.
La transacción de salida de mayor valor en los últimos seis meses.
La transacción de salida de mayor valor en los últimos doce meses.
El valor medio de salida de todas las transacciones en los últimos tres días.
El valor medio de salida de todas las transacciones de la última semana.
El valor medio de salida de todas las transacciones del mes pasado.
El valor medio de salida de todas las transacciones en los últimos tres meses.
El valor medio de salida de todas las transacciones en los últimos seis meses.
El valor medio de salida de todas las transacciones en los últimos doce meses.
El número de días en los que no ocurrieron transacciones en los últimos tres días.
El número de días en los que no ocurrieron transacciones durante la última semana.
El número de días en los que no se realizaron transacciones durante el último mes.
El número de días en los que no ocurrieron transacciones en los últimos tres meses.
El número de días en los que no ocurrieron transacciones en los últimos seis meses.
El número de días en los que no ocurrieron transacciones en los últimos doce meses.
El número de días desde que ocurrió la última transacción.
El número de días desde que ocurrió la última transacción de entrada.
El número de días desde que ocurrió la última transacción de salida.
Métricas agregadas calculadas basadas en las transacciones del usuario de cuentas corrientes, de ahorros, de crédito y de préstamos. Sin embargo, las transferencias internas (transferencias entre cuentas pertenecientes al mismo enlace) no se utilizan en el cálculo.
Si no hay suficientes datos transaccionales para un período dado, devolvemos null
. Por ejemplo, si la cuenta solo ha estado abierta durante 15 días (o solo has proporcionado datos para solo 15 días), devolvemos valores para _3d
, _1w
y _1m
, sin embargo, para _3m
devolveremos null
ya que no hay datos para los meses dos y tres.
El valor más alto de las transacciones de flujo de caja positivo en los últimos tres días.
El valor más alto de las transacciones de flujo de caja positivo de la última semana.
El valor más alto de las transacciones de flujo de caja positivo del mes pasado.
El valor más alto de las transacciones de flujo de caja positivo en los últimos tres meses.
El valor más alto de las transacciones de flujo de caja positivo en los últimos seis meses.
El valor más alto de las transacciones de flujo de caja positivo en los últimos doce meses.
El valor más alto de las transacciones de flujo de caja negativo en los últimos tres días.
El valor más alto de las transacciones de flujo de caja negativo en la última semana.
El valor más alto de las transacciones de flujo de caja negativo en el último mes.
El valor más alto de las transacciones de flujo de caja negativo en los últimos tres meses.
El valor más alto de las transacciones de flujo de caja negativo en los últimos seis meses.
El valor más alto de las transacciones de flujo de caja negativo en los últimos doce meses.
El valor medio de las transacciones de flujo de caja positivo en los últimos tres días.
El valor medio de las transacciones de flujo de caja positivo en la última semana.
El valor medio de las transacciones de flujo de caja positivo en el último mes.
El valor medio de las transacciones de flujo de caja positivo en los últimos tres meses.
El valor medio de las transacciones de flujo de caja positivo en los últimos seis meses.
El valor medio de las transacciones de flujo de caja positivo en los últimos doce meses.
El valor medio de las transacciones de flujo de caja negativo en los últimos tres días.
El valor medio de las transacciones de flujo de caja negativo en la última semana.
El valor medio de las transacciones de flujo de caja negativo en el último mes.
El valor medio de las transacciones de flujo de caja negativo en los últimos tres meses.
El valor medio de las transacciones de flujo de caja negativo en los últimos seis meses.
El valor medio de las transacciones de flujo de caja negativo en los últimos doce meses.
El total de todas las transacciones que resultaron en un flujo de caja positivo en los últimos tres días.
El total de todas las transacciones que resultaron en un flujo de caja positivo en la última semana.
El total de todas las transacciones que resultaron en un flujo de caja positivo en el último mes.
El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos tres meses.
El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos seis meses.
El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos doce meses.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos tres días.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas de la última semana.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas del último mes.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos tres meses.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos seis meses.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos doce meses.
El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos tres días.
El total de todas las transacciones que resultaron en un flujo de caja negativo en la última semana.
El total de todas las transacciones que resultaron en un flujo de caja negativo en el último mes.
El total de todas las transacciones que resultan en un flujo de caja negativo en los últimos tres meses.
El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos seis meses.
El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos doce meses.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos tres días.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas de la última semana.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas del último mes.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos tres meses.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos seis meses.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos doce meses.
La relación entre sum_positive / sum_negative en los últimos tres días.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egreso, el valor será null
.
La relación entre sum_positive / sum_negative en la última semana.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egresos, el valor será null
.
La relación entre sum_positive / sum_negative en el último mes.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egresos, el valor será null
.
La relación entre sum_positive / sum_negative en los últimos tres meses.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egresos, el valor será null
.
La relación entre sum_positive / sum_negative en los últimos seis meses.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egreso, el valor será null
.
La relación entre sum_positive / sum_negative en los últimos doce meses.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egresos, el valor será null
.
El flujo de caja neto en los últimos tres días.
El flujo de caja neto en la última semana.
El flujo de caja neto en el último mes.
El flujo de caja neto en los últimos tres meses.
El flujo de caja neto en los últimos seis meses.
El flujo de caja neto en los últimos doce meses.
La tendencia del flujo de caja neto en los últimos tres días meses.
La tendencia del flujo de caja neto en la última semana.
La tendencia del flujo de caja neto en el último mes.
La tendencia del flujo de caja neto en los últimos tres meses.
La tendencia del flujo de caja neto en los últimos seis meses.
Un array de métricas agregadas sobre las categorías y subcategorías de transacciones que Belvo ha identificado dentro del historial de transacciones del usuario.
En el array, Belvo solo devuelve las categorías que han sido identificadas.
El nombre de la categoría de transacción.
Obtener categorización de transacciones Con la categorización de transacciones, limpiamos y categorizamos las transacciones por ti, convirtiendo datos en bruto en información procesable. Para habilitar esta función, simplemente contáctanos y nos pondremos manos a la obra.
Devolvemos uno de los siguientes valores de 'enum':
Bills & Utilities
Credits & Loans
Deposits
Fees & Charges
Food & Groceries
Home & Life
Income & Payments
Insurance
Investments & Savings
Online Platforms & Leisure
Personal Shopping
Taxes
Transfers
Transport & Travel
Unknown
*Withdrawal & ATM
null
* Para los clientes que no utilizan nuestro producto de Categorización de Transacciones, devolvemos null
en su lugar.
La subcategoría de la transacción.
Obtener categorización de transacciones Para los clientes que no utilizan nuestra categorización de transacciones, devolvemos
null
en su lugar. Para habilitar esta función, simplemente contáctanos, y lo activaremos de inmediato.
Devolvemos uno de los siguientes valores de enum:
Electricity & Energy
Rent
Telecommunications
Water
Auto
Credit Card
Instalment
Interest & Charges
Mortgage
Pay Advance
Personal
Adjustments
Bank Fees
Chargeback
Refund
Blocked Balances
Alimony
Alcohol & Tobacco
Bakery & Coffee
Bars & Nightclubs
Convenience Store
Delivery
Groceries
Restaurants
Education
Gyms & Fitness
Hair & Beauty
Health
Home Decor & Appliances
Laundry & Dry Cleaning
Pharmacies
Professional Services
Veterinary Services
Freelance
Interest
Retirement
Salary
Government
Home Insurance
Auto Insurance
Health & Life Insurance
Savings
Fixed income
Equity
Investment Funds
Derivatives
Cryptocurrencies
Apps, Software and Cloud Services
Events, Parks and Museums
Gambling
Gaming
Lottery
Movie & Audio
Books & News
Clothing & Accessories
Department Store
Electronics
E-commerce
Gifts
Office Supplies
Pet Supplies
Auto Tax & Fees
Donation
Government Fees
Income Tax
Real Estate Tax & Fees
Tax Return
Accommodation
Auto Expenses
Auto Rental
Flights
Gas
Mileage Programs
Parking & Tolls
Public Transit
Taxis & Rideshares
Other
null
El monto neto de las transacciones para esta categoría en los últimos tres meses (calculado como el total de transacciones entrantes menos el total de transacciones salientes para esta categoría).
La proporción de net_amount_3m
dividida por la suma de todas las transacciones categorizadas entrantes (incluida la categoría actual) para el mismo período.
Nota: Si no hay transacciones de entrada para el período, este valor devolverá null
.
{ "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d", "link": "30cb4806-6e00-48a4-91c9-ca55968576c8", "created_at": "2022-02-09T08:45:50.406032Z", "accounts": [ "0d3ffb69-f83b-456e-ad8e-208d0998d71d", "00293c8e-1152-440b-9892-3c071fb88672", "cf638fba-ef45-4c10-bc6f-adecc4b2bf4e", "3861a5da-ae9b-4f20-a632-a9294489d5ac", "1f60315b-236d-498e-be7a-92bc613d329b", "a2c8da63-ed51-41e6-891a-4ae7e784463a" ], "assets_metrics": { "institutions": [ … ], "num_assets_accounts": 1, "num_checking_accounts": 1, "num_savings_accounts": 1, "checking_accounts_balance": 35901.46, "savings_accounts_balance": 300.02 }, "credit_cards_metrics": { "num_accounts": 2, "sum_credit_limit": 106560, "sum_credit_used": 101020.14, "credit_card_limit_utilization": 0.95 }, "loans_metrics": { "num_accounts": 1, "sum_loans_principal": 5000, "sum_loans_outstanding_principal": 2000, "sum_loans_monthly_payment": 400, "loan_limit_utilization": 0.3, "overdraft_limit": 900, "overdraft_limit_utilization": 0.4 }, "balances_metrics": { "closing_balance": 35901.46, "min_balance_3d": 35417.68, "min_balance_1w": 34150.5, "min_balance_1m": 33990.59, "min_balance_3m": 33990.59, "min_balance_6m": 33990.59, "min_balance_12m": 33990.59, "mean_balance_3d": 35659.57, "mean_balance_1w": 35077.1, "mean_balance_1m": 34816.08, "mean_balance_3m": 34816.08, "mean_balance_6m": 34816.08, "mean_balance_12m": 34816.08, "max_balance_3d": 35901.46, "max_balance_1w": 35901.46, "max_balance_1m": 35901.46, "max_balance_3m": 35901.46, "max_balance_6m": 35901.46, "max_balance_12m": 35901.46, "std_balance_3d": 279.31, "std_balance_1w": 764.03, "std_balance_1m": 586.55, "std_balance_3m": 586.55, "std_balance_6m": 586.55, "std_balance_12m": 586.55, "balance_trend_3d": 193.51, "balance_trend_1w": 290.18, "balance_trend_1m": 22.6, "balance_trend_3m": 22.6, "balance_trend_6m": 22.6, "balance_trend_12m": 22.6, "days_balance_below_0_3d": 0, "days_balance_below_0_1w": 0, "days_balance_below_0_1m": 0, "days_balance_below_0_3m": 0, "days_balance_below_0_6m": 0, "days_balance_below_0_12m": 0, "days_balance_below_mean_3d": 2, "days_balance_below_mean_1w": 3, "days_balance_below_mean_1m": 17, "days_balance_below_mean_3m": 17, "days_balance_below_mean_6m": 17, "days_balance_below_mean_12m": 17, "days_balance_below_x_3d": 0, "days_balance_below_x_1w": 0, "days_balance_below_x_1m": 0, "days_balance_below_x_3m": 0, "days_balance_below_x_6m": 0, "days_balance_below_x_12m": 0, "balance_threshold_x": 1000 }, "transactions_metrics": { "num_transactions_3d": 26, "num_transactions_1w": 46, "num_transactions_1m": 168, "num_transactions_3m": 460, "num_transactions_6m": 472, "num_transactions_12m": 496, "max_num_transactions_3d": 10, "max_num_transactions_1w": 10, "max_num_transactions_1m": 18, "max_num_transactions_3m": 18, "max_num_transactions_6m": 18, "max_num_transactions_12m": 18, "mean_num_transactions_3d": 6.5, "mean_num_transactions_1w": 5.75, "mean_num_transactions_1m": 5.42, "mean_num_transactions_3m": 5.05, "mean_num_transactions_6m": 2.61, "mean_num_transactions_12m": 1.37, "num_incoming_transactions_3d": 12, "num_incoming_transactions_1w": 21, "num_incoming_transactions_1m": 80, "num_incoming_transactions_3m": 229, "num_incoming_transactions_6m": 238, "num_incoming_transactions_12m": 256, "max_num_incoming_transactions_3d": 6, "max_num_incoming_transactions_1w": 6, "max_num_incoming_transactions_1m": 10, "max_num_incoming_transactions_3m": 10, "max_num_incoming_transactions_6m": 10, "max_num_incoming_transactions_12m": 10, "mean_num_incoming_transactions_3d": 3, "mean_num_incoming_transactions_1w": 2.62, "mean_num_incoming_transactions_1m": 2.58, "mean_num_incoming_transactions_3m": 2.52, "mean_num_incoming_transactions_6m": 1.31, "mean_num_incoming_transactions_12m": 0.71, "sum_incoming_amount_3d": 17142.16, "sum_incoming_amount_1w": 24825.92, "sum_incoming_amount_1m": 75993.36, "sum_incoming_amount_3m": 198197.28, "sum_incoming_amount_6m": 223697.28, "sum_incoming_amount_12m": 274697.28, "max_incoming_amount_3d": 3000, "max_incoming_amount_1w": 3000, "max_incoming_amount_1m": 3000, "max_incoming_amount_3m": 3000, "max_incoming_amount_6m": 3000, "max_incoming_amount_12m": 3000, "mean_incoming_amount_3d": 1428.51, "mean_incoming_amount_1w": 1182.19, "mean_incoming_amount_1m": 949.92, "mean_incoming_amount_3m": 865.49, "mean_incoming_amount_6m": 939.9, "mean_incoming_amount_12m": 1073.04, "num_outgoing_transactions_3d": 14, "num_outgoing_transactions_1w": 25, "num_outgoing_transactions_1m": 88, "num_outgoing_transactions_3m": 231, "num_outgoing_transactions_6m": 234, "num_outgoing_transactions_12m": 240, "max_num_outgoing_transactions_3d": 6, "max_num_outgoing_transactions_1w": 6, "max_num_outgoing_transactions_1m": 8, "max_num_outgoing_transactions_3m": 9, "max_num_outgoing_transactions_6m": 9, "max_num_outgoing_transactions_12m": 9, "mean_num_outgoing_transactions_3d": 3.5, "mean_num_outgoing_transactions_1w": 3.12, "mean_num_outgoing_transactions_1m": 2.84, "mean_num_outgoing_transactions_3m": 2.54, "mean_num_outgoing_transactions_6m": 1.29, "mean_num_outgoing_transactions_12m": 0.66, "sum_outgoing_amount_3d": 18246.95, "sum_outgoing_amount_1w": 26362.25, "sum_outgoing_amount_1m": 78243.82, "sum_outgoing_amount_3m": 192608.77, "sum_outgoing_amount_6m": 201608.77, "sum_outgoing_amount_12m": 219608.77, "max_outgoing_amount_3d": 3000, "max_outgoing_amount_1w": 3000, "max_outgoing_amount_1m": 3000, "max_outgoing_amount_3m": 3000, "max_outgoing_amount_6m": 3000, "max_outgoing_amount_12m": 3000, "mean_outgoing_amount_3d": 1303.35, "mean_outgoing_amount_1w": 1054.49, "mean_outgoing_amount_1m": 889.13, "mean_outgoing_amount_3m": 833.8, "mean_outgoing_amount_6m": 861.58, "mean_outgoing_amount_12m": 915.04, "days_without_transactions_3d": 0, "days_without_transactions_1w": 0, "days_without_transactions_1m": 0, "days_without_transactions_3m": 0, "days_without_transactions_6m": 87, "days_without_transactions_12m": 261, "days_since_last_transaction": 0, "days_since_last_incoming_transaction": 0, "days_since_last_outgoing_transaction": 0, "days_history": 365 }, "cashflow_metrics": { "max_positive_3d": 1850.12, "max_positive_1w": 3808.99, "max_positive_1m": 4012.61, "max_positive_3m": 5001.08, "max_positive_6m": 8500, "max_positive_12m": 8500, "max_negative_3d": 3375.43, "max_negative_1w": 3375.43, "max_negative_1m": 5305.92, "max_negative_3m": 7535.85, "max_negative_6m": 7535.85, "max_negative_12m": 7535.85, "mean_positive_3d": 1410.54, "mean_positive_1w": 1665.74, "mean_positive_1m": 1827.36, "mean_positive_3m": 1881.58, "mean_positive_6m": 2102.19, "mean_positive_12m": 2502.06, "mean_negative_3d": 3373.48, "mean_negative_1w": 2477.04, "mean_negative_1m": 1904.96, "mean_negative_3m": 1838.47, "mean_negative_6m": 1877.63, "mean_negative_12m": 1948.51, "sum_positive_3d": 5642.16, "sum_positive_1w": 13325.92, "sum_positive_1m": 52993.36, "sum_positive_3m": 163697.28, "sum_positive_6m": 189197.28, "sum_positive_12m": 240197.28, "sum_positive_trend_3d": 98.902, "sum_positive_trend_1w": -84.0393, "sum_positive_trend_1m": 22.7315, "sum_positive_trend_3m": 1.8398, "sum_positive_trend_6m": -17.1869, "sum_positive_trend_12m": -25.9856, "sum_negative_3d": 6746.95, "sum_negative_1w": 14862.25, "sum_negative_1m": 55243.82, "sum_negative_3m": 158108.77, "sum_negative_6m": 167108.77, "sum_negative_12m": 185108.77, "sum_negative_trend_3d": -3.91, "sum_negative_trend_1w": 254.2517, "sum_negative_trend_1m": 58.376, "sum_negative_trend_3m": 2.5895, "sum_negative_trend_6m": -1.4824, "sum_negative_trend_12m": -4.2394, "positive_to_negative_ratio_3d": 0.84, "positive_to_negative_ratio_1w": 0.9, "positive_to_negative_ratio_1m": 0.96, "positive_to_negative_ratio_3m": 1.04, "positive_to_negative_ratio_6m": 1.13, "positive_to_negative_ratio_12m": 1.3, "net_cashflow_3d": -1104.79, "net_cashflow_1w": -1536.33, "net_cashflow_1m": -2250.46, "net_cashflow_3m": 5588.51, "net_cashflow_6m": 22088.51, "net_cashflow_12m": 55088.51, "net_cashflow_trend_3d": 1448.683, "net_cashflow_trend_1w": 163.8856, "net_cashflow_trend_1m": 1.3034, "net_cashflow_trend_3m": -0.472, "net_cashflow_trend_6m": -15.1286, "net_cashflow_trend_12m": -21.5511 }, "category_metrics": [ { … } ] }
Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.
Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.
La sesión que deseas reanudar. Necesitas usar el valor de session
que se proporciona en la respuesta 428 Token Required que recibes después de realizar tu solicitud POST.
El token MFA generado por la institución que se requiere para continuar una sesión.
El link.id
que deseas reanudar. Debe ser el mismo link.id
que recibes en la respuesta 428 Token Required que contiene el ID de session
.
- Mock server
https://developers.belvo.com/_mock/es/apis/belvoopenapispec/api/risk-insights/
- Sandbox
https://sandbox.belvo.com/api/risk-insights/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
-u <username>:<password> \
'https://developers.belvo.com/_mock/es/apis/belvoopenapispec/api/risk-insights/?omit=string&fields=string' \
-H 'Content-Type: application/json' \
-d '{
"session": "6e7b283c6efa449c9c028a16b5c249fa",
"token": "1234ab",
"link": "683005d6-f45c-4adb-b289-f1a12f50f80c",
"save_data": true
}'
Ok (cuando save_data=false)
Identificador único de Belvo para el elemento actual.
El link.id
al que pertenecen los datos.
La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
Una matriz de números de cuenta generados por Belvo (UUIDs) que se utilizaron durante el análisis de perspectivas de riesgo. Si no se encontraron cuentas, devolvemos una matriz vacía.
Agregue detalles sobre los activos utilizados en el análisis de percepción de riesgos. Para las métricas de activos, solo consideramos cuentas corrientes y de ahorros.
Las métricas de activos pueden proporcionar una instantánea de la riqueza y los activos líquidos de su usuario, indicando cómo gestionan su riqueza y su estado financiero actual.
Una matriz de instituciones de las cuales se recuperó información de la cuenta para el usuario.
Nota: Para la mayoría de los casos de uso, esta matriz solo devolverá un elemento.
El número total de cuentas encontradas para el usuario.
El número total de cuentas corrientes encontradas para el usuario.
El número total de cuentas de ahorro encontradas para el usuario.
El saldo total de cierre de todas las cuentas corrientes.
Métricas agregadas calculadas en base a las cuentas de tarjetas de crédito del usuario.
Las métricas de tarjetas de crédito ilustran los hábitos de un cliente con sus tarjetas de crédito, revelando cuántas cuentas de tarjetas de crédito tiene un cliente, su límite de crédito total, cuánto de ese límite está utilizando y la tasa de utilización de su límite de crédito.
Número de cuentas de tarjetas de crédito asociadas al usuario.
Suma total de los límites de todas las tarjetas de crédito.
Suma total de todo el crédito utilizado.
Métricas agregadas calculadas en base a las cuentas de préstamo del usuario y las cuentas corrientes que tienen sobregiro.
Las métricas de préstamos ayudan a comprender el comportamiento de préstamo y reembolso de un cliente, lo que puede ayudar a evaluar su capacidad para asumir crédito adicional y los posibles riesgos de incumplimiento.
El número de cuentas de préstamo asociadas con el usuario.
Suma total del principal de todas las cuentas de préstamo del usuario.
Suma total del principal pendiente para todas las cuentas de préstamo del usuario.
Suma total de los pagos mensuales de todas las cuentas de préstamo del usuario.
El porcentaje del límite del préstamo utilizado.
El límite total de sobregiro de todas las cuentas corrientes y de ahorro.
Métricas de balance calculadas en base a los saldos del usuario de las cuentas corrientes y de ahorros.
El saldo de todas las cuentas en el momento collected_at
.
El saldo mínimo en los últimos tres días.
El saldo mínimo en los últimos tres meses.
El saldo mínimo en los últimos seis meses.
El saldo mínimo en los últimos doce meses.
El saldo medio en los últimos tres días.
El saldo medio en los últimos tres meses.
El saldo medio en los últimos seis meses.
El saldo medio en los últimos doce meses.
El saldo máximo en los últimos tres días.
El saldo máximo en los últimos tres meses.
El saldo máximo en los últimos seis meses.
El saldo máximo en los últimos doce meses.
La desviación estándar del balance en los últimos tres días.
La desviación estándar del balance en la última semana.
La desviación estándar del balance en el último mes.
La desviación estándar del balance en los últimos tres meses.
La desviación estándar del saldo en los últimos seis meses.
La desviación estándar del saldo en los últimos doce meses.
La tendencia del saldo del usuario en los últimos tres días.
La tendencia del saldo del usuario en la última semana.
La tendencia del saldo del usuario en el último mes.
La tendencia del saldo del usuario en los últimos tres meses.
La tendencia del saldo del usuario en los últimos seis meses.
La tendencia del saldo del usuario en los últimos doce meses.
El número de días en los que el saldo total de la cuenta es menor o igual a 0 en los últimos tres días.
El número de días en los que el saldo total de la cuenta es menor o igual a 0 en la última semana.
El número de días en que el saldo total de la cuenta es menor o igual a 0 en el último mes.
El número de días en los que el saldo total de la cuenta es menor o igual a 0 en los últimos tres meses.
El número de días en los que el saldo total de la cuenta es menor o igual a 0 en los últimos seis meses.
El número de días en que el saldo total de la cuenta es menor o igual a 0 en los últimos doce meses.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_3d
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_1w
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_1m
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_3m
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_6m
.
El número de días en que el saldo medio de la cuenta es menor o igual a la cantidad especificada en mean_daily_balance_12m
.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en los últimos tres días.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en la última semana.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en el último mes.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en los últimos tres meses.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en los últimos seis meses.
El número de días en los que el saldo total de la cuenta es menor o igual a la cantidad especificada en balance_threshold_x
en los últimos doce meses.
Métricas agregadas calculadas basadas en las transacciones del usuario de cuentas corrientes, de ahorros, de tarjetas de crédito y de préstamos.
ℹ️ Nota
Si no hay suficientes datos transaccionales para un período dado, devolvemos
null
para los campos calculados y0
para los campos basados en conteo. Por ejemplo, si la cuenta solo ha estado abierta durante cinco días (o si has proporcionado datos solo para cinco días), devolvemos valores para_3d
,_1w
y_1m
, sin embargo:
mean_num_transactions_3m
devolveránull
ya que no hay datos para los meses dos y tres (campo calculado).num_transactions_3m
devolverá0
ya que no hay datos para los meses dos y tres (campo basado en conteo).
El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos tres días (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo de la última semana (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo del último mes (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos tres meses (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos seis meses (entrantes y salientes).
El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos doce meses (entrantes y salientes).
El número máximo de transacciones de los últimos tres días.
El número máximo de transacciones de la última semana.
El número máximo de transacciones del último mes.
El número máximo de transacciones de los últimos tres meses.
El número máximo de transacciones de los últimos seis meses.
El número máximo de transacciones de los últimos doce meses.
El número medio de transacciones de los últimos tres días.
El número medio de transacciones de la última semana.
El número medio de transacciones del último mes.
El número medio de transacciones de los últimos tres meses.
El número medio de transacciones de los últimos seis meses.
El número medio de transacciones de los últimos doce meses.
El número total de transacciones de entrada en los últimos tres días.
El número total de transacciones de entrada de la última semana.
El número total de transacciones de entrada del mes pasado.
El número total de transacciones de entrada en los últimos tres meses.
El número total de transacciones de entrada en los últimos seis meses.
El número total de transacciones de entrada en los últimos doce meses.
El número máximo de transacciones de entrada de los últimos tres días.
El número máximo de transacciones de entrada de la última semana.
El número máximo de transacciones de entrada del mes pasado.
El número máximo de transacciones de entrada en los últimos tres meses.
El número máximo de transacciones de entrada en los últimos seis meses.
El número máximo de transacciones de entrada en los últimos doce meses.
El número medio de transacciones de entrada de los últimos tres días.
El número medio de transacciones de entrada de la última semana.
El número medio de transacciones de entrada del mes pasado.
El número promedio de transacciones de entrada durante los últimos tres meses.
El número medio de transacciones de entrada durante los últimos seis meses.
El número medio de transacciones de entrada durante los últimos doce meses.
La suma total de todas las transacciones de entrada de los últimos tres días.
La suma total de todas las transacciones de entrada de la última semana.
La suma total de todas las transacciones de entrada del mes pasado.
La suma total de todas las transacciones de entrada de los últimos tres meses.
La suma total de todas las transacciones de entrada de los últimos seis meses.
La suma total de todas las transacciones de entrada de los últimos doce meses.
La transacción de entrada de mayor valor en los últimos tres días.
La transacción de entrada de mayor valor en la última semana.
La transacción de entrada de mayor valor en el último mes.
La transacción de entrada de mayor valor en los últimos tres meses.
La transacción de entrada de mayor valor en los últimos seis meses.
La transacción de entrada de mayor valor en los últimos doce meses.
El valor medio entrante de todas las transacciones en los últimos tres días.
El valor medio entrante de todas las transacciones de la última semana.
El valor medio entrante de todas las transacciones del mes pasado.
El valor medio entrante de todas las transacciones en los últimos tres meses.
El valor medio entrante de todas las transacciones en los últimos seis meses.
El valor medio entrante de todas las transacciones en los últimos doce meses.
Al número total de transacciones de salida en los últimos tres días.
Al número total de transacciones de salida en la última semana.
Al total de transacciones de salida en el último mes.
Al número total de transacciones de salida en los últimos tres meses.
Al número total de transacciones de salida en los últimos seis meses.
Al número total de transacciones de salida en los últimos doce meses.
El número máximo de transacciones de salida de los últimos tres días.
El número máximo de transacciones de salida de la última semana.
El número máximo de transacciones de salida del último mes.
El número máximo de transacciones de salida en los últimos tres meses.
El número máximo de transacciones de salida en los últimos seis meses.
El número máximo de transacciones de salida en los últimos doce meses.
El número medio de transacciones de salida de los últimos tres días.
El número medio de transacciones de salida de la última semana.
El número medio de transacciones de salida del último mes.
El número medio de transacciones de salida durante los últimos tres meses.
El número medio de transacciones de salida durante los últimos seis meses.
El número medio de transacciones de salida durante los últimos doce meses.
La suma total de todas las transacciones de salida de los últimos tres días.
La suma total de todas las transacciones de salida de la última semana.
La suma total de todas las transacciones de salida del mes pasado.
La suma total de todas las transacciones de salida de los últimos tres meses.
La suma total de todas las transacciones de salida de los últimos seis meses.
La suma total de todas las transacciones de salida de los últimos doce meses.
La transacción de salida de mayor valor en los últimos tres días.
La transacción de salida de mayor valor en la última semana.
La transacción de salida de mayor valor en el último mes.
La transacción de salida de mayor valor en los últimos tres meses.
La transacción de salida de mayor valor en los últimos seis meses.
La transacción de salida de mayor valor en los últimos doce meses.
El valor medio de salida de todas las transacciones en los últimos tres días.
El valor medio de salida de todas las transacciones de la última semana.
El valor medio de salida de todas las transacciones del mes pasado.
El valor medio de salida de todas las transacciones en los últimos tres meses.
El valor medio de salida de todas las transacciones en los últimos seis meses.
El valor medio de salida de todas las transacciones en los últimos doce meses.
El número de días en los que no ocurrieron transacciones en los últimos tres días.
El número de días en los que no ocurrieron transacciones durante la última semana.
El número de días en los que no se realizaron transacciones durante el último mes.
El número de días en los que no ocurrieron transacciones en los últimos tres meses.
El número de días en los que no ocurrieron transacciones en los últimos seis meses.
El número de días en los que no ocurrieron transacciones en los últimos doce meses.
El número de días desde que ocurrió la última transacción.
El número de días desde que ocurrió la última transacción de entrada.
El número de días desde que ocurrió la última transacción de salida.
Métricas agregadas calculadas basadas en las transacciones del usuario de cuentas corrientes, de ahorros, de crédito y de préstamos. Sin embargo, las transferencias internas (transferencias entre cuentas pertenecientes al mismo enlace) no se utilizan en el cálculo.
Si no hay suficientes datos transaccionales para un período dado, devolvemos null
. Por ejemplo, si la cuenta solo ha estado abierta durante 15 días (o solo has proporcionado datos para solo 15 días), devolvemos valores para _3d
, _1w
y _1m
, sin embargo, para _3m
devolveremos null
ya que no hay datos para los meses dos y tres.
El valor más alto de las transacciones de flujo de caja positivo en los últimos tres días.
El valor más alto de las transacciones de flujo de caja positivo de la última semana.
El valor más alto de las transacciones de flujo de caja positivo del mes pasado.
El valor más alto de las transacciones de flujo de caja positivo en los últimos tres meses.
El valor más alto de las transacciones de flujo de caja positivo en los últimos seis meses.
El valor más alto de las transacciones de flujo de caja positivo en los últimos doce meses.
El valor más alto de las transacciones de flujo de caja negativo en los últimos tres días.
El valor más alto de las transacciones de flujo de caja negativo en la última semana.
El valor más alto de las transacciones de flujo de caja negativo en el último mes.
El valor más alto de las transacciones de flujo de caja negativo en los últimos tres meses.
El valor más alto de las transacciones de flujo de caja negativo en los últimos seis meses.
El valor más alto de las transacciones de flujo de caja negativo en los últimos doce meses.
El valor medio de las transacciones de flujo de caja positivo en los últimos tres días.
El valor medio de las transacciones de flujo de caja positivo en la última semana.
El valor medio de las transacciones de flujo de caja positivo en el último mes.
El valor medio de las transacciones de flujo de caja positivo en los últimos tres meses.
El valor medio de las transacciones de flujo de caja positivo en los últimos seis meses.
El valor medio de las transacciones de flujo de caja positivo en los últimos doce meses.
El valor medio de las transacciones de flujo de caja negativo en los últimos tres días.
El valor medio de las transacciones de flujo de caja negativo en la última semana.
El valor medio de las transacciones de flujo de caja negativo en el último mes.
El valor medio de las transacciones de flujo de caja negativo en los últimos tres meses.
El valor medio de las transacciones de flujo de caja negativo en los últimos seis meses.
El valor medio de las transacciones de flujo de caja negativo en los últimos doce meses.
El total de todas las transacciones que resultaron en un flujo de caja positivo en los últimos tres días.
El total de todas las transacciones que resultaron en un flujo de caja positivo en la última semana.
El total de todas las transacciones que resultaron en un flujo de caja positivo en el último mes.
El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos tres meses.
El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos seis meses.
El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos doce meses.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos tres días.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas de la última semana.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas del último mes.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos tres meses.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos seis meses.
La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos doce meses.
El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos tres días.
El total de todas las transacciones que resultaron en un flujo de caja negativo en la última semana.
El total de todas las transacciones que resultaron en un flujo de caja negativo en el último mes.
El total de todas las transacciones que resultan en un flujo de caja negativo en los últimos tres meses.
El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos seis meses.
El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos doce meses.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos tres días.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas de la última semana.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas del último mes.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos tres meses.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos seis meses.
La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos doce meses.
La relación entre sum_positive / sum_negative en los últimos tres días.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egreso, el valor será null
.
La relación entre sum_positive / sum_negative en la última semana.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egresos, el valor será null
.
La relación entre sum_positive / sum_negative en el último mes.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egresos, el valor será null
.
La relación entre sum_positive / sum_negative en los últimos tres meses.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egresos, el valor será null
.
La relación entre sum_positive / sum_negative en los últimos seis meses.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egreso, el valor será null
.
La relación entre sum_positive / sum_negative en los últimos doce meses.
ℹ️ Si la relación es mayor que 1
, significa que el usuario tiene más ingresos que egresos, lo que indica que gasta menos de lo que gana.
Nota: En el caso de que no haya habido transacciones de egresos, el valor será null
.
El flujo de caja neto en los últimos tres días.
El flujo de caja neto en la última semana.
El flujo de caja neto en el último mes.
El flujo de caja neto en los últimos tres meses.
El flujo de caja neto en los últimos seis meses.
El flujo de caja neto en los últimos doce meses.
La tendencia del flujo de caja neto en los últimos tres días meses.
La tendencia del flujo de caja neto en la última semana.
La tendencia del flujo de caja neto en el último mes.
La tendencia del flujo de caja neto en los últimos tres meses.
La tendencia del flujo de caja neto en los últimos seis meses.
Un array de métricas agregadas sobre las categorías y subcategorías de transacciones que Belvo ha identificado dentro del historial de transacciones del usuario.
En el array, Belvo solo devuelve las categorías que han sido identificadas.
El nombre de la categoría de transacción.
Obtener categorización de transacciones Con la categorización de transacciones, limpiamos y categorizamos las transacciones por ti, convirtiendo datos en bruto en información procesable. Para habilitar esta función, simplemente contáctanos y nos pondremos manos a la obra.
Devolvemos uno de los siguientes valores de 'enum':
Bills & Utilities
Credits & Loans
Deposits
Fees & Charges
Food & Groceries
Home & Life
Income & Payments
Insurance
Investments & Savings
Online Platforms & Leisure
Personal Shopping
Taxes
Transfers
Transport & Travel
Unknown
*Withdrawal & ATM
null
* Para los clientes que no utilizan nuestro producto de Categorización de Transacciones, devolvemos null
en su lugar.
La subcategoría de la transacción.
Obtener categorización de transacciones Para los clientes que no utilizan nuestra categorización de transacciones, devolvemos
null
en su lugar. Para habilitar esta función, simplemente contáctanos, y lo activaremos de inmediato.
Devolvemos uno de los siguientes valores de enum:
Electricity & Energy
Rent
Telecommunications
Water
Auto
Credit Card
Instalment
Interest & Charges
Mortgage
Pay Advance
Personal
Adjustments
Bank Fees
Chargeback
Refund
Blocked Balances
Alimony
Alcohol & Tobacco
Bakery & Coffee
Bars & Nightclubs
Convenience Store
Delivery
Groceries
Restaurants
Education
Gyms & Fitness
Hair & Beauty
Health
Home Decor & Appliances
Laundry & Dry Cleaning
Pharmacies
Professional Services
Veterinary Services
Freelance
Interest
Retirement
Salary
Government
Home Insurance
Auto Insurance
Health & Life Insurance
Savings
Fixed income
Equity
Investment Funds
Derivatives
Cryptocurrencies
Apps, Software and Cloud Services
Events, Parks and Museums
Gambling
Gaming
Lottery
Movie & Audio
Books & News
Clothing & Accessories
Department Store
Electronics
E-commerce
Gifts
Office Supplies
Pet Supplies
Auto Tax & Fees
Donation
Government Fees
Income Tax
Real Estate Tax & Fees
Tax Return
Accommodation
Auto Expenses
Auto Rental
Flights
Gas
Mileage Programs
Parking & Tolls
Public Transit
Taxis & Rideshares
Other
null
El monto neto de las transacciones para esta categoría en los últimos tres meses (calculado como el total de transacciones entrantes menos el total de transacciones salientes para esta categoría).
La proporción de net_amount_3m
dividida por la suma de todas las transacciones categorizadas entrantes (incluida la categoría actual) para el mismo período.
Nota: Si no hay transacciones de entrada para el período, este valor devolverá null
.
[ { "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d", "link": "30cb4806-6e00-48a4-91c9-ca55968576c8", "created_at": "2022-02-09T08:45:50.406032Z", "accounts": [ … ], "assets_metrics": { … }, "credit_cards_metrics": { … }, "loans_metrics": { … }, "balances_metrics": { … }, "transactions_metrics": { … }, "cashflow_metrics": { … }, "category_metrics": [ … ] } ]
Bank Accounts (Brazil)
Para recibir pagos entrantes en la cuenta bancaria de su organización, debe registrar las cuentas bancarias (individuales y empresariales) utilizando la Payments API de Belvo.
- Las cuentas bancarias individuales deben ser creadas para cada pagador (su cliente).
- Las cuentas bancarias empresariales deben ser creadas para el beneficiario del pago (su organización).
Payment Intents (Brazil)
Un payment intent es un punto único de acceso para crear pagos utilizando cualquier método de pago ofrecido por Belvo.
Un payment intent captura toda la información del pago (como el monto a cobrar, la descripción del pago, el proveedor, etc.) y guía a tus clientes a través del flujo de pago.
Nota: Para las instituciones que requieren el
username_type
en el arrayform_fields
, debes enviar este valor en tu solicitud PATCH.