> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linahealthcareplatform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sistema de Créditos

> Cómo funciona el consumo de créditos via API

## ¿Qué son los créditos?

Los créditos son la unidad de consumo en LINA. Cada acción que involucra IA, comunicación con pacientes o procesamiento avanzado consume créditos — **tanto desde la plataforma como via API**.

<Warning>
  **Importante:** Las llamadas API que consumen créditos lo hacen de la misma manera que si ejecutaras la acción desde el panel web. No hay diferencia de coste.
</Warning>

## Consumo por acción

| Acción                          | Créditos | Notas                        |
| ------------------------------- | -------- | ---------------------------- |
| Programar formulario (email)    | 2        | Por envío                    |
| Programar formulario (SMS)      | 3        | Por envío                    |
| Programar formulario (WhatsApp) | 5        | Por envío                    |
| Programar formulario (app)      | 1        | Por envío                    |
| Iniciar conversación IA (chat)  | 10       | Por sesión                   |
| Mensaje en conversación         | 1        | Por mensaje enviado          |
| Iniciar llamada IA              | 15       | Coste base                   |
| Llamada IA (por minuto)         | 10       | Adicional por min            |
| Consultar API (sin IA)          | 0        | CRUD pacientes, listar, etc. |

## Ejemplo: Llamada de seguimiento

```
Iniciar llamada:         15 créditos
Duración (3 minutos):    30 créditos (10 × 3)
─────────────────────────────────────
Total:                   45 créditos
```

## Consultar saldo

```bash theme={null}
curl https://api.linahealthcareplatform.com/api/v1/billing/balance \
  -H "Authorization: Bearer YOUR_TOKEN"
```

```json theme={null}
{
  "balance": 1847,
  "plan": "Pro",
  "monthlyAllowance": 2000,
  "usedThisMonth": 153,
  "resetsAt": "2026-06-01T00:00:00Z"
}
```

## Webhook de créditos bajos

Registra un webhook para recibir una alerta cuando tu saldo sea bajo:

```bash theme={null}
curl -X POST https://api.linahealthcareplatform.com/api/v1/webhooks \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-servidor.com/webhook",
    "events": ["credits.low"]
  }'
```

Se dispara automáticamente cuando el saldo cae por debajo del **10%** de tu asignación mensual.

## Planes y límites

| Plan       | Créditos/mes  | Precio     |
| ---------- | ------------- | ---------- |
| Básico     | 1.000         | 26,96€/mes |
| Pro        | 2.000         | 44,96€/mes |
| Enterprise | Personalizado | Contactar  |

<Info>
  Los créditos no usados **no se acumulan** al mes siguiente. El contador se reinicia el día 1 de cada mes.
</Info>

## Créditos adicionales

Si necesitas más créditos durante el mes, puedes comprar packs adicionales desde **Configuración → Facturación** o contactar con ventas para un plan Enterprise.