Explorar la documentación
Plans & credits

Créditos y medición

Cómo funciona el libro de créditos, las dos salvaguardas que detienen un exceso, y por qué tu fecha de renovación no es el primero del mes.

BoostEcom es una cuota mensual fija que incluye créditos. No hay factura por token que descifrar a fin de mes.

Los importes por nivel viven en Planes y límites — deliberadamente en un solo lugar, para que nunca puedan contradecirse entre sí.

El libro

Los créditos son un libro de solo adición, no un contador que se sobrescribe. Cada concesión y cada consumo es una fila. Tu saldo es la suma, lo que significa:

  • El historial es auditable: siempre puedes ver qué consumió qué.
  • Un bug puede añadir una fila de corrección, nunca reescribir el pasado en silencio.
  • GET /api/usage lee el libro en vivo, no una cifra cacheada.

Margen

El uso del modelo se factura al 1,5× el coste subyacente del proveedor en los niveles de pago, y al 1,0× en Custom. Ese multiplicador es el margen y se declara en lugar de ocultarse dentro de una unidad de "crédito" opaca.

Las dos salvaguardas

Ambas son duras, y ambas se aplican en cada plan y cada nivel de autonomía:

1. Estimación previa al streaming. Antes de que una solicitud corra, se estima su coste. Si la estimación supera tu saldo, la solicitud se rechaza con 402 y nada se transmite. Nunca se te cobra por una solicitud que iba a agotarse de todos modos.

2. Techo duro a mitad de streaming. Una generación larga se mide mientras corre. En el momento en que el coste acumulado alcanza tu saldo, el streaming se interrumpe. Una solicitud nunca puede llevar tu saldo a negativo.

La renovación es tu aniversario, no el día 1

Los créditos mensuales se reinician en el día ancla de tu suscripción, el día del mes en que te suscribiste, no el primero. Una tienda que se suscribió el día 18 se renueva el día 18.

El cron diario recorre las organizaciones cuyo día ancla es hoy. Cada concesión es idempotente: el cron, el webhook subscription.created y el respaldo invoice.paid escriben todos a través de la misma clave, así que tres caminos hacia los créditos del mismo mes solo los otorgan una vez.

Bono diario

Los niveles de pago acumulan un pequeño bono diario además de la asignación mensual. Es por organización, y expira a medianoche UTC sin acumularse. Los importes están en Planes y límites.

Impuesto

Stripe Tax está activo en el checkout (IVA de la UE e impuesto sobre ventas de EE. UU.). Cuando compras créditos, la concesión lee el importe antes de impuestos. Nunca se te otorgan créditos por el impuesto que pagaste, ni tampoco se te resta por él.

Leer tu uso

| Superficie | Qué ofrece | |---|---| | GET /api/usage | El libro en vivo de tu organización. | | /<org>/~/billing | Estado de la suscripción, facturas, plan. | | /<org>/~/billing/activate | Tras el checkout: el estado real de cada webhook antes de devolver el control. |

Este último merece conocerse. Tras un checkout, muestra si el pago, la suscripción, el cambio de plan y la concesión de créditos han aterrizado realmente cada uno, en lugar de hacer correr un temporizador y esperar.

¿Has construido con estas docs?

Pásate por el foro si algo no está claro o es incorrecto. La documentación mejora más rápido cuando los lectores señalan los huecos.

Abrir el foro