# Créditos: un solo balance para toda la API

**Publicado:** 4 de septiembre de 2026 | **Autores:** Cristian Correa, Tomás Calle

---

Hoy estamos agregando billing a la plataforma Croma. Sabemos que cambiar cómo se cobra algo genera preguntas, así que esta entrada explica cada regla y cada número, sin letra pequeña. La idea que guía todo: pagas por lo que la API te sirve, ves tu balance en todo momento y nunca te enteras de un límite por sorpresa.

Si ya tienes una organización, no tienes que hacer nada. Ya está en el plan Free, con créditos para este mes, y tu consola muestra el balance desde hoy.

## Qué cambia, en una frase

Antes cada organización tenía un tope de 100 solicitudes por día, igual para todos. Ahora cada organización tiene un balance mensual de **créditos**, y cada solicitud consume créditos según lo que cuesta atenderla. El tope diario desaparece.

## Cómo funcionan los créditos

Dos tipos de solicitud, un solo balance:

| Solicitud | Créditos | Qué es |
| --- | --- | --- |
| Live | 10 | Un endpoint de datos por país o global que consulta la fuente oficial en el momento en que lo llamas: procesos judiciales, registros mercantiles, vehículos, antecedentes, búsqueda web, extracción. |
| Datasets | 1 | Un endpoint que responde desde las tablas de Croma, actualizadas con regularidad: contratación pública, normativa, gacetas, jurisprudencia. Su guía lo indica y responde en milisegundos. |

La diferencia de precio refleja la diferencia de costo. Una consulta live a la fuente oficial tiene un costo real cada vez; un dataset ya está listo. Con un mismo balance puedes elegir la mezcla que te sirva: 500 consultas live, 5.000 consultas a datasets, o cualquier combinación.

```mermaid
flowchart TD
  A["Solicitud a la API"] --> B{"Qué endpoint"}
  B -->|"Live: fuente oficial"| C["10 créditos"]
  B -->|"Datasets de Croma"| D["1 crédito"]
  C --> E["Un solo balance por organización"]
  D --> E
  E -->|"Balance agotado"| F["402 hasta el reinicio o el upgrade"]
```

Las reglas, todas:

- Los créditos se reinician en la fecha mensual de tu plan. Los que no uses no se acumulan.
- Las solicitudes en lote consumen por elemento: un lote de 10 consultas live consume 100 créditos.
- Una solicitud que falla no consume nada. Una respuesta desde caché consume lo mismo que una nueva.
- Consultar el estado de un job asíncrono nunca consume créditos.
- Búsqueda web, extracción y research conservan sus topes por hora. Protegen a las fuentes, no a tu bolsillo.

## Los planes

Todos los planes incluyen el catálogo completo, el servidor MCP y la consola. La única diferencia es cuántos créditos recibes cada mes.

| Plan | Precio | Créditos al mes | Equivale a |
| --- | --- | --- | --- |
| Free | USD 0 | 5.000 | 500 consultas live o 5.000 consultas a datasets |
| Hobby | USD 20 | 20.000 | 2.000 consultas live o 20.000 consultas a datasets |
| Standard | USD 99 | 100.000 | 10.000 consultas live o 100.000 consultas a datasets |
| Contrato | A medida | Lo que acordemos | Mayor volumen, billing a medida o condiciones propias |

Cada 1.000 créditos cuestan un dólar en los planes pagos. Free no pide tarjeta. Mejorar de plan aplica de inmediato y se prorratea; bajar de plan aplica al final del periodo; cancelar se hace en un clic desde el portal de billing. Los detalles están en [la página de precios](/pricing).

## Lo que ves en cada respuesta

Tu código ve el mismo número que tú. Cada respuesta de la API trae el balance en sus encabezados, en créditos:

```http
X-RateLimit-Limit: 20000
X-RateLimit-Remaining: 19988
X-RateLimit-Reset: 2026-10-04T04:19:37.174Z
RateLimit-Policy: "credits";q=20000;w=2592000
```

Cuando el balance se agota, la API responde `402` con un mensaje que dice qué hacer, y vuelve a responder normal en cuanto mejoras el plan o llega el reinicio:

```json
{
  "error": {
    "type": "billing_error",
    "code": "plan_limit_reached",
    "message": "Your plan has no credits left for this period. Upgrade at https://platform.usecroma.com/billing or wait until 2026-10-04T04:19:37.174Z."
  }
}
```

El código de error y los encabezados están documentados en [límites de tasa](https://docs.usecroma.com/es/rate-limits).

## Notificaciones antes de que pase algo

Nadie debería descubrir un límite en producción. Por eso los administradores de tu organización reciben un correo cuando el consumo llega al 80% de los créditos del mes, y otro si se agotan. El correo dice cuánto llevas, cuánto tienes y cuándo se reinicia, con el enlace directo a tu consola para decidir con calma.

## Tu consola

En [platform.usecroma.com/billing](https://platform.usecroma.com/billing) ves tu plan, tu balance de créditos, la fecha de reinicio y los planes disponibles. Desde ahí mejoras de plan con Stripe, gestionas tu método de pago, descargas facturas o cancelas. Solo los administradores de la organización pueden cambiar el plan; el resto del equipo ve los mismos números.

## Contratos

Si tu volumen supera Standard, necesitas billing a medida o prefieres condiciones propias, hablamos y lo dejamos en un contrato con su propio número de créditos al mes. En la API y en la consola se ve exactamente igual que cualquier otro plan: mismos encabezados, mismo balance, mismas notificaciones. Solo cambia quién envía la factura.

## Crecemos juntos

Este modelo lo construimos con una convicción: que cada peso que inviertes en Croma se convierta en datos que te sirven, y que puedas ver esa relación con claridad. Empezar es gratis, crecer es proporcional y ninguna decisión se toma a oscuras. Si algo de esto no te cuadra, o tienes un caso que estas reglas no cubren bien, [cuéntanos](https://cal.com/tomas-calle-croma/15min). Ajustamos con gusto.

---

**Más novedades:** [Ver todas las entradas del changelog](/es/changelog/sitemap.md) | [Croma](https://usecroma.com)