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.
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.
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:
X-RateLimit-Limit: 20000
X-RateLimit-Remaining: 19988
X-RateLimit-Reset: 2026-10-04T04:19:37.174Z
RateLimit-Policy: "credits";q=20000;w=2592000Cuando 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:
{
"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.
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 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. Ajustamos con gusto.