Skip to content

Documentación de la API de Belvo (1.222.0)

Introducción

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:

Información Disponible y Métodos de Pago

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

Diccionarios de Datos

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).

Entornos

Actualmente ofrecemos dos entornos: sandbox y producción.

Sandbox

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.

Producción

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 a api.belvo.com.
  • Si estás usando webhooks, asegúrate de establecer una URL de Producción para tus webhooks.

Códigos de Respuesta

Usamos el siguiente código de estado HTTP en la respuesta dependiendo del éxito o fracaso:

Código de EstadoDescripció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.
400Error de Solicitud Incorrecta - La solicitud devolvió un error, detalle en el contenido.
401No Autorizado - Las credenciales de Belvo proporcionadas no son válidas.
404No Encontrado - El recurso al que intentas acceder no se puede encontrar.
405Método No Permitido - El método HTTP que estás usando no es aceptado para este recurso.
408Tiempo de Solicitud Agotado - La solicitud se agotó y fue terminada por el servidor.
428Se Requiere Token MFA - La institución requirió un token MFA para conectar.
500Error Interno del Servidor - El detalle del error está disponible en el cuerpo de la respuesta.

Manejo de Errores

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.

Identificador de Solicitud

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.

Códigos de Error y Solución de Problemas

Para una lista completa de errores y cómo solucionarlos, por favor consulta nuestro artículo dedicado Manejo de Errores.

Política de Reintentos

Errores 50x

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).

Errores 40x

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.

Campos Obsoletos

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.

OpenAPI: campos requeridos y anulables

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.

Descargar el archivo de descripción OpenAPI
Idiomas
Servidores
Mock server

https://developers.belvo.com/_mock/es/apis/belvoopenapispec/

Sandbox

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.
Operaciones

Widget Access Token

Operaciones

Consents

Un consentimiento es un permiso otorgado por el usuario final para acceder a sus datos financieros en la Red de Finanzas Abiertas en Brasil.

Operaciones

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
Operaciones

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.
Operaciones

Balances

Un saldo es la cantidad de dinero disponible en una cuenta bancaria determinada (corriente o de ahorros) en un momento dado.

Operaciones

Transactions

Una transacción contiene la información detallada de cada movimiento dentro de una cuenta. Por ejemplo, una compra en una tienda o un restaurante.

Operaciones

Bills

Una bill se refiere a la factura de la tarjeta de crédito que un usuario recibe para una cuenta determinada.

Operaciones

Investments Brazil

Operaciones

Investment Transactions Brazil

Operaciones

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)
Operaciones

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)
Operaciones

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.

Operaciones

Invoices

Operaciones

Tax compliance status

Operaciones

Tax returns

Operaciones

Tax retentions

Operaciones

Tax status

Operaciones

Financial Statements

Operaciones

Invoices Chile

Operaciones

Tax Status Chile

Operaciones

Debt Reports Chile

Operaciones

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.

Operaciones

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.

Operaciones

Risk Insights

Operaciones

Obtener los detalles de una perspectiva de riesgo

Solicitud

Obtén los detalles de una perspectiva de riesgo específica.

Seguridad
basicAuth
Ruta
idstring(uuid)requerido

El risk-insights.id sobre el que deseas obtener información detallada.

Consulta
omitstring

Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

fieldsstring

Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

curl -i -X GET \
  -u <username>:<password> \
  'https://developers.belvo.com/_mock/es/apis/belvoopenapispec/api/risk-insights/{id}/?omit=string&fields=string'

Respuestas

De acuerdo

Cuerpoapplication/jsonArray [
idstring(uuid)requerido

Identificador único de Belvo para el elemento actual.

Ejemplo: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"
linkstring or null(uuid)requerido

El link.id al que pertenecen los datos.

Ejemplo: "30cb4806-6e00-48a4-91c9-ca55968576c8"
created_atstring(date-time)requerido

La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.

Ejemplo: "2022-02-09T08:45:50.406032Z"
accountsArray of strings or null(uuid)requerido

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.

Ejemplo: ["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_metricsobject or nullrequerido

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.

institutionsArray of strings or nullrequerido

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.

Ejemplo: ["erebor_mx_retail"]
num_assets_accountsinteger or null(int32)

El número total de cuentas encontradas para el usuario.

Ejemplo: 1
num_checking_accountsinteger or null(int32)requerido

El número total de cuentas corrientes encontradas para el usuario.

Ejemplo: 1
num_savings_accountsinteger or null(int32)requerido

El número total de cuentas de ahorro encontradas para el usuario.

Ejemplo: 1
checking_accounts_balancenumber or null(float)requerido

El saldo total de cierre de todas las cuentas corrientes.

Ejemplo: 35901.46
savings_accounts_balancenumber or null(float)requerido

El saldo total de cierre de todas las cuentas de ahorro.

Ejemplo: 300.02
credit_cards_metricsobject or nullrequerido

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.

num_accountsinteger(int32)>= 0requerido

Número de cuentas de tarjetas de crédito asociadas al usuario.

Ejemplo: 2
sum_credit_limitnumber or null(float)requerido

Suma total de los límites de todas las tarjetas de crédito.

Ejemplo: 106560
sum_credit_usednumber or null(float)requerido

Suma total de todo el crédito utilizado.

Ejemplo: 101020.14
credit_card_limit_utilizationnumber or null(float)requerido

El porcentaje del límite de la tarjeta de crédito utilizado.

Ejemplo: 0.95
loans_metricsobject or nullrequerido

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.

num_accountsinteger(int32)requerido

El número de cuentas de préstamo asociadas con el usuario.

Ejemplo: 1
sum_loans_principalnumber or null(float)requerido

Suma total del principal de todas las cuentas de préstamo del usuario.

Ejemplo: 5000
sum_loans_outstanding_principalnumber or null(float)requerido

Suma total del principal pendiente para todas las cuentas de préstamo del usuario.

Ejemplo: 2000
sum_loans_monthly_paymentnumber or null(float)requerido

Suma total de los pagos mensuales de todas las cuentas de préstamo del usuario.

Ejemplo: 400
loan_limit_utilizationnumber or null(float)requerido

El porcentaje del límite del préstamo utilizado.

Ejemplo: 0.3
overdraft_limitnumber or null(float)requerido

El límite total de sobregiro de todas las cuentas corrientes y de ahorro.

Ejemplo: 900
overdraft_limit_utilizationnumber or null(float)requerido

El porcentaje del límite de sobregiro utilizado.

Ejemplo: 0.4
balances_metricsobject or nullrequerido

Métricas de balance calculadas en base a los saldos del usuario de las cuentas corrientes y de ahorros.

closing_balancenumber or null(float)requerido

El saldo de todas las cuentas en el momento collected_at.

Ejemplo: 35901.46
min_balance_3dnumber or null(float)requerido

El saldo mínimo en los últimos tres días.

Ejemplo: 35417.68
min_balance_1wnumber or null(float)requerido

El saldo mínimo en la última semana).

Ejemplo: 34150.5
min_balance_1mnumber or null(float)requerido

El saldo mínimo en el último mes.

Ejemplo: 33990.59
min_balance_3mnumber or null(float)requerido

El saldo mínimo en los últimos tres meses.

Ejemplo: 33990.59
min_balance_6mnumber or null(float)requerido

El saldo mínimo en los últimos seis meses.

Ejemplo: 33990.59
min_balance_12mnumber or null(float)requerido

El saldo mínimo en los últimos doce meses.

Ejemplo: 33990.59
mean_balance_3dnumber or null(float)requerido

El saldo medio en los últimos tres días.

Ejemplo: 35659.57
mean_balance_1wnumber or null(float)requerido

El saldo medio en la última semana.

Ejemplo: 35077.1
mean_balance_1mnumber or null(float)requerido

El saldo medio en el último mes.

Ejemplo: 34816.08
mean_balance_3mnumber or null(float)requerido

El saldo medio en los últimos tres meses.

Ejemplo: 34816.08
mean_balance_6mnumber or null(float)requerido

El saldo medio en los últimos seis meses.

Ejemplo: 34816.08
mean_balance_12mnumber or null(float)requerido

El saldo medio en los últimos doce meses.

Ejemplo: 34816.08
max_balance_3dnumber or null(float)requerido

El saldo máximo en los últimos tres días.

Ejemplo: 35901.46
max_balance_1wnumber or null(float)requerido

El saldo máximo en la última semana.

Ejemplo: 35901.46
max_balance_1mnumber or null(float)requerido

El saldo máximo en el último mes.

Ejemplo: 35901.46
max_balance_3mnumber or null(float)requerido

El saldo máximo en los últimos tres meses.

Ejemplo: 35901.46
max_balance_6mnumber or null(float)requerido

El saldo máximo en los últimos seis meses.

Ejemplo: 35901.46
max_balance_12mnumber or null(float)requerido

El saldo máximo en los últimos doce meses.

Ejemplo: 35901.46
std_balance_3dnumber or null(float)requerido

La desviación estándar del balance en los últimos tres días.

Ejemplo: 279.31
std_balance_1wnumber or null(float)requerido

La desviación estándar del balance en la última semana.

Ejemplo: 764.03
std_balance_1mnumber or null(float)requerido

La desviación estándar del balance en el último mes.

Ejemplo: 586.55
std_balance_3mnumber or null(float)requerido

La desviación estándar del balance en los últimos tres meses.

Ejemplo: 586.55
std_balance_6mnumber or null(float)requerido

La desviación estándar del saldo en los últimos seis meses.

Ejemplo: 586.55
std_balance_12mnumber or null(float)requerido

La desviación estándar del saldo en los últimos doce meses.

Ejemplo: 586.55
balance_trend_3dnumber or null(float)requerido

La tendencia del saldo del usuario en los últimos tres días.

Ejemplo: 193.51
balance_trend_1wnumber or null(float)requerido

La tendencia del saldo del usuario en la última semana.

Ejemplo: 290.18
balance_trend_1mnumber or null(float)requerido

La tendencia del saldo del usuario en el último mes.

Ejemplo: 22.6
balance_trend_3mnumber or null(float)requerido

La tendencia del saldo del usuario en los últimos tres meses.

Ejemplo: 22.6
balance_trend_6mnumber or null(float)requerido

La tendencia del saldo del usuario en los últimos seis meses.

Ejemplo: 22.6
balance_trend_12mnumber or null(float)requerido

La tendencia del saldo del usuario en los últimos doce meses.

Ejemplo: 22.6
days_balance_below_0_3dinteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_0_1winteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_0_1minteger or null(int32)requerido

El número de días en que el saldo total de la cuenta es menor o igual a 0 en el último mes.

Ejemplo: 0
days_balance_below_0_3minteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_0_6minteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_0_12minteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_mean_3dinteger or null(int32)requerido

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.

Ejemplo: 2
days_balance_below_mean_1winteger or null(int32)requerido

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.

Ejemplo: 3
days_balance_below_mean_1minteger or null(int32)requerido

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.

Ejemplo: 17
days_balance_below_mean_3minteger or null(int32)requerido

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.

Ejemplo: 17
days_balance_below_mean_6minteger or null(int32)requerido

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.

Ejemplo: 17
days_balance_below_mean_12minteger or null(int32)requerido

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.

Ejemplo: 17
days_balance_below_x_3dinteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_x_1winteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_x_1minteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_x_3minteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_x_6minteger or null(int32)requerido

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.

Ejemplo: 0
days_balance_below_x_12minteger or null(int32)requerido

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.

Ejemplo: 0
balance_threshold_xnumber(float)requerido

El umbral utilizado para calcular days_balance_below_x_period. Tenga en cuenta que este valor es específico del país (tanto en términos de la cantidad como de la moneda).

Ejemplo: 1000
transactions_metricsobject or nullrequerido

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 y 0 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).
num_transactions_3dinteger(int32)requerido

El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos tres días (entrantes y salientes).

Predeterminado 0
Ejemplo: 26
num_transactions_1winteger(int32)requerido

El número total de transacciones analizadas para determinar las perspectivas de riesgo de la última semana (entrantes y salientes).

Predeterminado 0
Ejemplo: 46
num_transactions_1minteger(int32)requerido

El número total de transacciones analizadas para determinar las perspectivas de riesgo del último mes (entrantes y salientes).

Predeterminado 0
Ejemplo: 168
num_transactions_3minteger(int32)requerido

El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos tres meses (entrantes y salientes).

Predeterminado 0
Ejemplo: 460
num_transactions_6minteger(int32)requerido

El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos seis meses (entrantes y salientes).

Predeterminado 670
Ejemplo: 472
num_transactions_12minteger(int32)requerido

El número total de transacciones analizadas para determinar las perspectivas de riesgo durante los últimos doce meses (entrantes y salientes).

Predeterminado 0
Ejemplo: 496
max_num_transactions_3dinteger(int32)requerido

El número máximo de transacciones de los últimos tres días.

Predeterminado 0
Ejemplo: 10
max_num_transactions_1winteger(int32)requerido

El número máximo de transacciones de la última semana.

Predeterminado 0
Ejemplo: 10
max_num_transactions_1minteger(int32)requerido

El número máximo de transacciones del último mes.

Predeterminado 0
Ejemplo: 18
max_num_transactions_3minteger(int32)requerido

El número máximo de transacciones de los últimos tres meses.

Predeterminado 0
Ejemplo: 18
max_num_transactions_6minteger(int32)requerido

El número máximo de transacciones de los últimos seis meses.

Predeterminado 0
Ejemplo: 18
max_num_transactions_12minteger(int32)requerido

El número máximo de transacciones de los últimos doce meses.

Predeterminado 0
Ejemplo: 18
mean_num_transactions_3dnumber(float)requerido

El número medio de transacciones de los últimos tres días.

Predeterminado 0
Ejemplo: 6.5
mean_num_transactions_1wnumber(float)requerido

El número medio de transacciones de la última semana.

Predeterminado 0
Ejemplo: 5.75
mean_num_transactions_1mnumber(float)requerido

El número medio de transacciones del último mes.

Predeterminado 0
Ejemplo: 5.42
mean_num_transactions_3mnumber(float)requerido

El número medio de transacciones de los últimos tres meses.

Predeterminado 0
Ejemplo: 5.05
mean_num_transactions_6mnumber(float)requerido

El número medio de transacciones de los últimos seis meses.

Predeterminado 0
Ejemplo: 2.61
mean_num_transactions_12mnumber(float)requerido

El número medio de transacciones de los últimos doce meses.

Predeterminado 0
Ejemplo: 1.37
num_incoming_transactions_3dinteger(int32)requerido

El número total de transacciones de entrada en los últimos tres días.

Predeterminado 0
Ejemplo: 12
num_incoming_transactions_1winteger(int32)requerido

El número total de transacciones de entrada de la última semana.

Predeterminado 0
Ejemplo: 21
num_incoming_transactions_1minteger(int32)requerido

El número total de transacciones de entrada del mes pasado.

Predeterminado 0
Ejemplo: 80
num_incoming_transactions_3minteger(int32)requerido

El número total de transacciones de entrada en los últimos tres meses.

Predeterminado 0
Ejemplo: 229
num_incoming_transactions_6minteger(int32)requerido

El número total de transacciones de entrada en los últimos seis meses.

Predeterminado 0
Ejemplo: 238
num_incoming_transactions_12minteger(int32)requerido

El número total de transacciones de entrada en los últimos doce meses.

Predeterminado 0
Ejemplo: 256
max_num_incoming_transactions_3dinteger(int32)requerido

El número máximo de transacciones de entrada de los últimos tres días.

Predeterminado 0
Ejemplo: 6
max_num_incoming_transactions_1winteger(int32)requerido

El número máximo de transacciones de entrada de la última semana.

Predeterminado 0
Ejemplo: 6
max_num_incoming_transactions_1minteger(int32)requerido

El número máximo de transacciones de entrada del mes pasado.

Predeterminado 0
Ejemplo: 10
max_num_incoming_transactions_3minteger(int32)requerido

El número máximo de transacciones de entrada en los últimos tres meses.

Predeterminado 0
Ejemplo: 10
max_num_incoming_transactions_6minteger(int32)requerido

El número máximo de transacciones de entrada en los últimos seis meses.

Predeterminado 0
Ejemplo: 10
max_num_incoming_transactions_12minteger(int32)requerido

El número máximo de transacciones de entrada en los últimos doce meses.

Predeterminado 0
Ejemplo: 10
mean_num_incoming_transactions_3dnumber(float)requerido

El número medio de transacciones de entrada de los últimos tres días.

Predeterminado 0
Ejemplo: 3
mean_num_incoming_transactions_1wnumber(float)requerido

El número medio de transacciones de entrada de la última semana.

Predeterminado 0
Ejemplo: 2.62
mean_num_incoming_transactions_1mnumber(float)requerido

El número medio de transacciones de entrada del mes pasado.

Predeterminado 0
Ejemplo: 2.58
mean_num_incoming_transactions_3mnumber(float)requerido

El número promedio de transacciones de entrada durante los últimos tres meses.

Predeterminado 0
Ejemplo: 2.52
mean_num_incoming_transactions_6mnumber(float)requerido

El número medio de transacciones de entrada durante los últimos seis meses.

Predeterminado 0
Ejemplo: 1.31
mean_num_incoming_transactions_12mnumber(float)requerido

El número medio de transacciones de entrada durante los últimos doce meses.

Predeterminado 0
Ejemplo: 0.71
sum_incoming_amount_3dnumber or null(float)requerido

La suma total de todas las transacciones de entrada de los últimos tres días.

Ejemplo: 17142.16
sum_incoming_amount_1wnumber or null(float)requerido

La suma total de todas las transacciones de entrada de la última semana.

Ejemplo: 24825.92
sum_incoming_amount_1mnumber or null(float)requerido

La suma total de todas las transacciones de entrada del mes pasado.

Ejemplo: 75993.36
sum_incoming_amount_3mnumber or null(float)requerido

La suma total de todas las transacciones de entrada de los últimos tres meses.

Ejemplo: 198197.28
sum_incoming_amount_6mnumber or null(float)requerido

La suma total de todas las transacciones de entrada de los últimos seis meses.

Ejemplo: 223697.28
sum_incoming_amount_12mnumber or null(float)requerido

La suma total de todas las transacciones de entrada de los últimos doce meses.

Ejemplo: 274697.28
max_incoming_amount_3dnumber or null(float)requerido

La transacción de entrada de mayor valor en los últimos tres días.

Ejemplo: 3000
max_incoming_amount_1wnumber or null(float)requerido

La transacción de entrada de mayor valor en la última semana.

Ejemplo: 3000
max_incoming_amount_1mnumber or null(float)requerido

La transacción de entrada de mayor valor en el último mes.

Ejemplo: 3000
max_incoming_amount_3mnumber or null(float)requerido

La transacción de entrada de mayor valor en los últimos tres meses.

Ejemplo: 3000
max_incoming_amount_6mnumber or null(float)requerido

La transacción de entrada de mayor valor en los últimos seis meses.

Ejemplo: 3000
max_incoming_amount_12mnumber or null(float)requerido

La transacción de entrada de mayor valor en los últimos doce meses.

Ejemplo: 3000
mean_incoming_amount_3dnumber or null(float)requerido

El valor medio entrante de todas las transacciones en los últimos tres días.

Ejemplo: 1428.51
mean_incoming_amount_1wnumber or null(float)requerido

El valor medio entrante de todas las transacciones de la última semana.

Ejemplo: 1182.19
mean_incoming_amount_1mnumber or null(float)requerido

El valor medio entrante de todas las transacciones del mes pasado.

Ejemplo: 949.92
mean_incoming_amount_3mnumber or null(float)requerido

El valor medio entrante de todas las transacciones en los últimos tres meses.

Ejemplo: 865.49
mean_incoming_amount_6mnumber or null(float)requerido

El valor medio entrante de todas las transacciones en los últimos seis meses.

Ejemplo: 939.9
mean_incoming_amount_12mnumber or null(float)requerido

El valor medio entrante de todas las transacciones en los últimos doce meses.

Ejemplo: 1073.04
num_outgoing_transactions_3dinteger(int32)requerido

Al número total de transacciones de salida en los últimos tres días.

Predeterminado 0
Ejemplo: 14
num_outgoing_transactions_1winteger(int32)requerido

Al número total de transacciones de salida en la última semana.

Predeterminado 0
Ejemplo: 25
num_outgoing_transactions_1minteger(int32)requerido

Al total de transacciones de salida en el último mes.

Predeterminado 0
Ejemplo: 88
num_outgoing_transactions_3minteger(int32)requerido

Al número total de transacciones de salida en los últimos tres meses.

Predeterminado 0
Ejemplo: 231
num_outgoing_transactions_6minteger(int32)requerido

Al número total de transacciones de salida en los últimos seis meses.

Predeterminado 0
Ejemplo: 234
num_outgoing_transactions_12minteger(int32)requerido

Al número total de transacciones de salida en los últimos doce meses.

Predeterminado 0
Ejemplo: 240
max_num_outgoing_transactions_3dinteger(int32)requerido

El número máximo de transacciones de salida de los últimos tres días.

Predeterminado 0
Ejemplo: 6
max_num_outgoing_transactions_1winteger(int32)requerido

El número máximo de transacciones de salida de la última semana.

Predeterminado 0
Ejemplo: 6
max_num_outgoing_transactions_1minteger(int32)requerido

El número máximo de transacciones de salida del último mes.

Predeterminado 0
Ejemplo: 8
max_num_outgoing_transactions_3minteger(int32)requerido

El número máximo de transacciones de salida en los últimos tres meses.

Predeterminado 0
Ejemplo: 9
max_num_outgoing_transactions_6minteger(int32)requerido

El número máximo de transacciones de salida en los últimos seis meses.

Predeterminado 0
Ejemplo: 9
max_num_outgoing_transactions_12minteger(int32)requerido

El número máximo de transacciones de salida en los últimos doce meses.

Predeterminado 0
Ejemplo: 9
mean_num_outgoing_transactions_3dnumber(float)requerido

El número medio de transacciones de salida de los últimos tres días.

Predeterminado 0
Ejemplo: 3.5
mean_num_outgoing_transactions_1wnumber(float)requerido

El número medio de transacciones de salida de la última semana.

Predeterminado 0
Ejemplo: 3.12
mean_num_outgoing_transactions_1mnumber(float)requerido

El número medio de transacciones de salida del último mes.

Predeterminado 0
Ejemplo: 2.84
mean_num_outgoing_transactions_3mnumber(float)requerido

El número medio de transacciones de salida durante los últimos tres meses.

Predeterminado 0
Ejemplo: 2.54
mean_num_outgoing_transactions_6mnumber(float)requerido

El número medio de transacciones de salida durante los últimos seis meses.

Predeterminado 0
Ejemplo: 1.29
mean_num_outgoing_transactions_12mnumber(float)requerido

El número medio de transacciones de salida durante los últimos doce meses.

Predeterminado 0
Ejemplo: 0.66
sum_outgoing_amount_3dnumber or null(float)requerido

La suma total de todas las transacciones de salida de los últimos tres días.

Ejemplo: 18246.95
sum_outgoing_amount_1wnumber or null(float)requerido

La suma total de todas las transacciones de salida de la última semana.

Ejemplo: 26362.25
sum_outgoing_amount_1mnumber or null(float)requerido

La suma total de todas las transacciones de salida del mes pasado.

Ejemplo: 78243.82
sum_outgoing_amount_3mnumber or null(float)requerido

La suma total de todas las transacciones de salida de los últimos tres meses.

Ejemplo: 192608.77
sum_outgoing_amount_6mnumber or null(float)requerido

La suma total de todas las transacciones de salida de los últimos seis meses.

Ejemplo: 201608.77
sum_outgoing_amount_12mnumber or null(float)requerido

La suma total de todas las transacciones de salida de los últimos doce meses.

Ejemplo: 219608.77
max_outgoing_amount_3dnumber or null(float)requerido

La transacción de salida de mayor valor en los últimos tres días.

Ejemplo: 3000
max_outgoing_amount_1wnumber or null(float)requerido

La transacción de salida de mayor valor en la última semana.

Ejemplo: 3000
max_outgoing_amount_1mnumber or null(float)requerido

La transacción de salida de mayor valor en el último mes.

Ejemplo: 3000
max_outgoing_amount_3mnumber or null(float)requerido

La transacción de salida de mayor valor en los últimos tres meses.

Ejemplo: 3000
max_outgoing_amount_6mnumber or null(float)requerido

La transacción de salida de mayor valor en los últimos seis meses.

Ejemplo: 3000
max_outgoing_amount_12mnumber or null(float)requerido

La transacción de salida de mayor valor en los últimos doce meses.

Ejemplo: 3000
mean_outgoing_amount_3dnumber or null(float)requerido

El valor medio de salida de todas las transacciones en los últimos tres días.

Ejemplo: 1303.35
mean_outgoing_amount_1wnumber or null(float)requerido

El valor medio de salida de todas las transacciones de la última semana.

Ejemplo: 1054.49
mean_outgoing_amount_1mnumber or null(float)requerido

El valor medio de salida de todas las transacciones del mes pasado.

Ejemplo: 889.13
mean_outgoing_amount_3mnumber or null(float)requerido

El valor medio de salida de todas las transacciones en los últimos tres meses.

Ejemplo: 833.8
mean_outgoing_amount_6mnumber or null(float)requerido

El valor medio de salida de todas las transacciones en los últimos seis meses.

Ejemplo: 861.58
mean_outgoing_amount_12mnumber or null(float)requerido

El valor medio de salida de todas las transacciones en los últimos doce meses.

Ejemplo: 915.04
days_without_transactions_3dinteger(int32)requerido

El número de días en los que no ocurrieron transacciones en los últimos tres días.

Predeterminado 0
Ejemplo: 0
days_without_transactions_1winteger(int32)requerido

El número de días en los que no ocurrieron transacciones durante la última semana.

Predeterminado 0
Ejemplo: 0
days_without_transactions_1minteger(int32)requerido

El número de días en los que no se realizaron transacciones durante el último mes.

Predeterminado 0
Ejemplo: 0
days_without_transactions_3minteger(int32)requerido

El número de días en los que no ocurrieron transacciones en los últimos tres meses.

Predeterminado 0
Ejemplo: 0
days_without_transactions_6minteger(int32)requerido

El número de días en los que no ocurrieron transacciones en los últimos seis meses.

Predeterminado 0
Ejemplo: 87
days_without_transactions_12minteger(int32)requerido

El número de días en los que no ocurrieron transacciones en los últimos doce meses.

Predeterminado 0
Ejemplo: 261
days_since_last_transactioninteger(int32)requerido

El número de días desde que ocurrió la última transacción.

Predeterminado 0
Ejemplo: 0
days_since_last_incoming_transactioninteger(int32)requerido

El número de días desde que ocurrió la última transacción de entrada.

Predeterminado 0
Ejemplo: 0
days_since_last_outgoing_transactioninteger(int32)requerido

El número de días desde que ocurrió la última transacción de salida.

Predeterminado 0
Ejemplo: 0
days_historyinteger(int32)requerido

El número de días entre cuando se realizó la solicitud de información de riesgo y la primera transacción.

Predeterminado 0
Ejemplo: 365
cashflow_metricsobject or nullrequerido

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.

max_positive_3dnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja positivo en los últimos tres días.

Ejemplo: 1850.12
max_positive_1wnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja positivo de la última semana.

Ejemplo: 3808.99
max_positive_1mnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja positivo del mes pasado.

Ejemplo: 4012.61
max_positive_3mnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja positivo en los últimos tres meses.

Ejemplo: 5001.08
max_positive_6mnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja positivo en los últimos seis meses.

Ejemplo: 8500
max_positive_12mnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja positivo en los últimos doce meses.

Ejemplo: 8500
max_negative_3dnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja negativo en los últimos tres días.

Ejemplo: 3375.43
max_negative_1wnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja negativo en la última semana.

Ejemplo: 3375.43
max_negative_1mnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja negativo en el último mes.

Ejemplo: 5305.92
max_negative_3mnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja negativo en los últimos tres meses.

Ejemplo: 7535.85
max_negative_6mnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja negativo en los últimos seis meses.

Ejemplo: 7535.85
max_negative_12mnumber or null(float)requerido

El valor más alto de las transacciones de flujo de caja negativo en los últimos doce meses.

Ejemplo: 7535.85
mean_positive_3dnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja positivo en los últimos tres días.

Ejemplo: 1410.54
mean_positive_1wnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja positivo en la última semana.

Ejemplo: 1665.74
mean_positive_1mnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja positivo en el último mes.

Ejemplo: 1827.36
mean_positive_3mnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja positivo en los últimos tres meses.

Ejemplo: 1881.58
mean_positive_6mnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja positivo en los últimos seis meses.

Ejemplo: 2102.19
mean_positive_12mnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja positivo en los últimos doce meses.

Ejemplo: 2502.06
mean_negative_3dnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja negativo en los últimos tres días.

Ejemplo: 3373.48
mean_negative_1wnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja negativo en la última semana.

Ejemplo: 2477.04
mean_negative_1mnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja negativo en el último mes.

Ejemplo: 1904.96
mean_negative_3mnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja negativo en los últimos tres meses.

Ejemplo: 1838.47
mean_negative_6mnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja negativo en los últimos seis meses.

Ejemplo: 1877.63
mean_negative_12mnumber or null(float)requerido

El valor medio de las transacciones de flujo de caja negativo en los últimos doce meses.

Ejemplo: 1948.51
sum_positive_3dnumber or null(float)requerido

El total de todas las transacciones que resultaron en un flujo de caja positivo en los últimos tres días.

Ejemplo: 5642.16
sum_positive_1wnumber or null(float)requerido

El total de todas las transacciones que resultaron en un flujo de caja positivo en la última semana.

Ejemplo: 13325.92
sum_positive_1mnumber or null(float)requerido

El total de todas las transacciones que resultaron en un flujo de caja positivo en el último mes.

Ejemplo: 52993.36
sum_positive_3mnumber or null(float)requerido

El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos tres meses.

Ejemplo: 163697.28
sum_positive_6mnumber or null(float)requerido

El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos seis meses.

Ejemplo: 189197.28
sum_positive_12mnumber or null(float)requerido

El total de todas las transacciones que conducen a un flujo de caja positivo en los últimos doce meses.

Ejemplo: 240197.28
sum_positive_trend_3dnumber or null(float)requerido

La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos tres días.

Ejemplo: 98.902
sum_positive_trend_1wnumber or null(float)requerido

La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas de la última semana.

Ejemplo: -84.0393
sum_positive_trend_1mnumber or null(float)requerido

La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas del último mes.

Ejemplo: 22.7315
sum_positive_trend_3mnumber or null(float)requerido

La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos tres meses.

Ejemplo: 1.8398
sum_positive_trend_6mnumber or null(float)requerido

La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos seis meses.

Ejemplo: -17.1869
sum_positive_trend_12mnumber or null(float)requerido

La tendencia de flujo de caja positivo basada en la suma de todas las transacciones positivas en los últimos doce meses.

Ejemplo: -25.9856
sum_negative_3dnumber or null(float)requerido

El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos tres días.

Ejemplo: 6746.95
sum_negative_1wnumber or null(float)requerido

El total de todas las transacciones que resultaron en un flujo de caja negativo en la última semana.

Ejemplo: 14862.25
sum_negative_1mnumber or null(float)requerido

El total de todas las transacciones que resultaron en un flujo de caja negativo en el último mes.

Ejemplo: 55243.82
sum_negative_3mnumber or null(float)requerido

El total de todas las transacciones que resultan en un flujo de caja negativo en los últimos tres meses.

Ejemplo: 158108.77
sum_negative_6mnumber or null(float)requerido

El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos seis meses.

Ejemplo: 167108.77
sum_negative_12mnumber or null(float)requerido

El total de todas las transacciones que resultaron en un flujo de caja negativo en los últimos doce meses.

Ejemplo: 185108.77
sum_negative_trend_3dnumber or null(float)requerido

La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos tres días.

Ejemplo: -3.91
sum_negative_trend_1wnumber or null(float)requerido

La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas de la última semana.

Ejemplo: 254.2517
sum_negative_trend_1mnumber or null(float)requerido

La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas del último mes.

Ejemplo: 58.376
sum_negative_trend_3mnumber or null(float)requerido

La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos tres meses.

Ejemplo: 2.5895
sum_negative_trend_6mnumber or null(float)requerido

La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos seis meses.

Ejemplo: -1.4824
sum_negative_trend_12mnumber or null(float)requerido

La tendencia de flujo de caja negativo basada en la suma de todas las transacciones negativas en los últimos doce meses.

Ejemplo: -4.2394
positive_to_negative_ratio_3dnumber or null(float)requerido

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.

Ejemplo: 0.84
positive_to_negative_ratio_1wnumber or null(float)requerido

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.

Ejemplo: 0.9
positive_to_negative_ratio_1mnumber or null(float)requerido

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.

Ejemplo: 0.96
positive_to_negative_ratio_3mnumber or null(float)requerido

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.

Ejemplo: 1.04
positive_to_negative_ratio_6mnumber or null(float)requerido

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.

Ejemplo: 1.13
positive_to_negative_ratio_12mnumber or null(float)requerido

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.

Ejemplo: 1.3
net_cashflow_3dnumber or null(float)requerido

El flujo de caja neto en los últimos tres días.

Ejemplo: -1104.79
net_cashflow_1wnumber or null(float)requerido

El flujo de caja neto en la última semana.

Ejemplo: -1536.33
net_cashflow_1mnumber or null(float)requerido

El flujo de caja neto en el último mes.

Ejemplo: -2250.46
net_cashflow_3mnumber or null(float)requerido

El flujo de caja neto en los últimos tres meses.

Ejemplo: 5588.51
net_cashflow_6mnumber or null(float)requerido

El flujo de caja neto en los últimos seis meses.

Ejemplo: 22088.51
net_cashflow_12mnumber or null(float)requerido

El flujo de caja neto en los últimos doce meses.

Ejemplo: 55088.51
net_cashflow_trend_3dnumber or null(float)requerido

La tendencia del flujo de caja neto en los últimos tres días meses.

Ejemplo: 1448.683
net_cashflow_trend_1wnumber or null(float)requerido

La tendencia del flujo de caja neto en la última semana.

Ejemplo: 163.8856
net_cashflow_trend_1mnumber or null(float)requerido

La tendencia del flujo de caja neto en el último mes.

Ejemplo: 1.3034
net_cashflow_trend_3mnumber or null(float)requerido

La tendencia del flujo de caja neto en los últimos tres meses.

Ejemplo: -0.472
net_cashflow_trend_6mnumber or null(float)requerido

La tendencia del flujo de caja neto en los últimos seis meses.

Ejemplo: -15.1286
net_cashflow_trend_12mnumber or null(float)requerido

La tendencia del flujo de caja neto en los últimos doce meses.

Ejemplo: -21.5511
category_metricsArray of objectsrequerido

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.

categorystring or null

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.

Enum"Bills & Utilities""Credits & Loans""Deposits""Fees & Charges""Food & Groceries""Home & Life""Income & Payments""Insurance""Investments & Savings""Online Platforms & Leisure"
Ejemplo: "Income & Payments"
subcategorystring or null

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
Enum"Electricity & Energy""Rent""Telecommunications""Water""Auto""Credit Card""Instalment""Interest & Charges""Mortgage""Pay Advance"
Ejemplo: "Freelance"
net_amount_3mnumber or null(float)

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).

Ejemplo: 642.76
category_inflow_ratio_3mnumber or null(float)

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.

Ejemplo: 1
trend_3mnumber or null(float)

La tendencia de transacciones netas de la categoría (transacciones entrantes - transacciones salientes para la categoría) para el período.

Ejemplo: 0
]
Respuesta
application/json
[ { "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": [] } ]

Eliminar una perspectiva de riesgo

Solicitud

Eliminar una percepción de riesgo específica de tu cuenta de Belvo.

Seguridad
basicAuth
Ruta
idstring(uuid)requerido

El risk-insights.id que deseas eliminar

curl -i -X DELETE \
  -u <username>:<password> \
  'https://developers.belvo.com/_mock/es/apis/belvoopenapispec/api/risk-insights/{id}/'

Respuestas

No hay contenido

Respuesta
Sin contenido

Employment Metrics

Operaciones

Payment Institutions (Brazil)

Una institución de pago es una entidad de la que Belvo puede acceder a información. Puedes ver una lista completa de instituciones disponibles para pagos haciendo una solicitud de Lista a este endpoint.

Operaciones

Customers (Brazil)

Un customer es el pagador que va a transferir fondos a tu cuenta bancaria. Necesitas crear un customer para recibir pagos entrantes en la cuenta bancaria de tu organización.

Operaciones

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).
Operaciones

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 array form_fields, debes enviar este valor en tu solicitud PATCH.

Operaciones

Payment Authorizations (Brazil)

Una Autorización de Pago es el consentimiento que tu usuario te da para cargar (debitando dinero de) sus cuentas. Necesitas realizar una Autorización de Pago por cada ‘contrato’ (por ejemplo, si tu empresa maneja tanto electricidad como agua pero se facturan por separado, entonces deberás crear dos Autorizaciones de Pago separadas).

Una vez que el usuario confirma la autorización, necesitarás escuchar un webhook PAYMENT_AUTHORIZATION con el estado configurado en AUTHORIZED. Una vez que recibas este webhook, el proceso de autorización estará completo y podrás cargar a tu usuario.

¿Qué es un cargo?

Un cargo representa el pago individual (débito) que tu cliente realizará.

Encabezado de Versión

El recurso de Autorización de Pago requiere que envíes el encabezado X-Belvo-API-Resource-Version configurado en Payments-BR.V2.

Operaciones

Biometric Pix Widget Access Token (Brazil)

Utilice las solicitudes de Token del Biometric Pix Widget para crear un token de acceso para Pagos Biométricos.

Operaciones

Enrollments (Brazil)

Operaciones

Payment Transactions (Brazil)

Cada vez que recibes un pago entrante de tu cliente, se crea una transacción en la base de datos de Belvo.

Puedes utilizar el recurso de Payment Transactions para obtener información útil sobre una transacción, así como el cargo específico asociado con ella.

Operaciones