# Incomes

> 🚧 Solicitar transacciones primero
Antes de solicitar ingresos, **debes primero** hacer una solicitud POST Retrieve Transactions.
Si no solicitas las transacciones, los análisis no podrán realizarse.
Nota: Recomendamos que hagas la solicitud POST Retrieve Transactions **justo antes** de hacer tu solicitud de ingresos para asegurar que todos los datos se calculen correctamente.


Nuestro recurso de **Incomes** te proporciona información sobre las fuentes de ingreso de un enlace bancario.

Utiliza el recurso de Incomes para obtener información sobre las fuentes de ingreso de una cuenta en los últimos 365 días. El endpoint es particularmente útil cuando deseas verificar el ingreso de una persona.

> 📘 El recurso de Incomes solo está disponible para cuentas de Cheques y Ahorros asociadas con enlaces bancarios.


Utiliza este recurso para obtener información sobre un enlace bancario:

- fuente de ingreso y confianza
- puntuaciones de estabilidad y regularidad
- lista de transacciones utilizadas para determinar la fuente de ingreso


Ofrecemos los siguientes métodos para interactuar con Incomes:

| Endpoints | Método | Descripción |
|  --- | --- | --- |
| Retrieve | `POST` | Recuperar información de ingresos de un enlace específico. El período es de hasta 365 días y depende del historial de transacciones disponible para cada banco. |
| Listar | `GET` | Lista los ingresos asociados con tu cuenta de Belvo. |
| Detalle | `GET` | Obtén los detalles de un ingreso específico. |
| Eliminar | `DELETE` | Elimina un ingreso específico de tu cuenta de Belvo. |


## Obtener mejores datos de ingresos

Para que la verificación de ingresos devuelva datos precisos, tu usuario necesita conectar la cuenta en la que recibe su salario. Si vinculan una cuenta que no incluye sus transacciones salariales, nuestra API devolverá un array vacío.

💡 Para evitar recibir un array vacío, asegúrate de indicar a tu usuario que deben conectar la cuenta que recibe su salario.

Además, recomendamos implementar un mecanismo donde, si tu usuario conecta una cuenta que no contiene transacciones salariales, le notifiques que la cuenta que conectaron no contenía información salarial y les pidas que conecten otra cuenta.

# Gastos recurrentes

> 🚧 Solicita cuentas y transacciones primero
Antes de solicitar gastos recurrentes, **debes primero** realizar una solicitud POST Retrieve Transactions.
Si no solicitas transacciones, no se podrán realizar los análisis.
Nota: Recomendamos que realices la solicitud POST Retrieve Transactions **justo antes** de hacer tu solicitud de gastos recurrentes para asegurar que todos los datos se calculen correctamente.


El recurso 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. Esta información es extremadamente útil cuando deseas ayudar a los usuarios a gestionar sus obligaciones futuras.

> 📘 El recurso de gastos recurrentes solo está disponible para cuentas Corriente y de Ahorros asociadas con enlaces bancarios. Devolvemos información de hasta 365 días.
Si no se pueden identificar gastos recurrentes, devolvemos un array vacío.


Para cada transacción recurrente, devolvemos los datos enriquecidos (tipo de transacción, categoría, montos promedio) así como la información de la cuenta y transacción de soporte. Consulta nuestra referencia de la API de gastos recurrentes para obtener información detallada sobre cada punto de datos que devolvemos.

```json
[
  {
    "id": "076c66e5-90f5-4e01-99c7-50e32f65ae42",
    "account": {}, // Información sobre la cuenta en la que encontramos la transacción recurrente
    "name": "Netflix",
    "transactions": [ // Array de transacciones que identificamos como cíclicas
      {
        "amount": 32.9,
        "description": "Netflix.com/march",
        "value_date": "2019-10-23"
      },
      {
        "amount": 32.9,
        "description": "Netflix.com/april",
        "value_date": "2019-10-23"
      },
      {
        "amount": 32.9,
        "description": "Netflix.com/may",
        "value_date": "2019-10-23"
      }
    ],
    "frequency": "MONTHLY", // Con qué frecuencia ocurre la transacción
    "average_transaction_amount": 32.9, // Monto promedio de la transacción
    "median_transaction_amount": 32.9,
    "days_since_last_transaction": 5, // Te ayuda a identificar cuánto falta para la próxima transacción
    "category": "Online Platforms & Leisure", // Categoría de la transacción
    "payment_type": "SUBSCRIPTION" // Categoría del método de pago
  }
]
```

| Endpoints | Método | Descripción |
|  --- | --- | --- |
| Retrieve | `POST` | Recupera información sobre gastos recurrentes de un enlace específico. El período es de hasta 365 días y depende del historial de transacciones disponible para cada banco. |
| List | `GET` | Lista los gastos recurrentes asociados con tu cuenta de Belvo. |
| Detail | `GET` | Obtén los detalles de un gasto recurrente. |
| Destroy | `DELETE` | Elimina un gasto recurrente específico de tu cuenta de Belvo. |


# Información de riesgo

> 🚧 Solicita cuentas y transacciones primero
Antes de solicitar información de riesgo, **debes primero** realizar una solicitud POST Retrieve Accounts y una POST Retrieve Transactions.
Si no solicitas las cuentas y transacciones, los análisis no podrán llevarse a cabo.
Nota: Recomendamos que realices las solicitudes POST Retrieve Accounts y POST Retrieve Transactions **justo antes** de hacer tu solicitud de información de riesgo para asegurar que todos los datos se calculen correctamente.


Construir un modelo de crédito requiere un análisis meticuloso de datos, cálculo de variables y limpieza de datos. El recurso de Información de Riesgo de Belvo ofrece una lista completa de características pre-calculadas, proporcionando a los equipos de ciencia de datos bloques de construcción para crear, iterar y validar rápidamente sus modelos.

> 📘 Para calcular la información de riesgo, tomamos hasta 365 días de datos transaccionales de las cuentas de cheques, ahorros, inversión, préstamo y tarjeta de crédito del usuario.


| Endpoints | Método | Descripción |
|  --- | --- | --- |
| Retrieve | `POST` | Recupera información de riesgo para un enlace específico. El período es de hasta 90 días y depende del historial de transacciones disponible para cada banco. |
| List | `GET` | Lista todos los análisis de información de riesgo asociados con tu cuenta de Belvo. |
| Detail | `GET` | Obtén los detalles de un análisis de información de riesgo. |
| Destroy | `DELETE` | Elimina un análisis de información de riesgo específico de tu cuenta de Belvo. |