Facturación y gasto
Una organización comparte un único monedero que financia la facturación por uso de sus miembros y de sus agentes inscritos. Los admin lo recargan, el uso de todos consume de él y los admin pueden fijar límites de gasto para acotar la velocidad a la que se consume. Gestiona todo esto desde la consola de la organización → Ajustes → Billing.
Los créditos son la unidad de uso medido (1 USD = 100 créditos); consulta la Visión general de la API para saber qué es gratuito y qué se mide en la API para desarrolladores.
El monedero de la organización
GET /org/{orgId}/wallet devuelve el saldo de la organización y su libro mayor
reciente. Cualquier miembro de la organización puede ver el monedero; solo los
admin/owner pueden recargarlo.
- Saldo: créditos compartidos (con una porción en efectivo cuando corresponde) que financian los agentes y las ejecuciones de la organización.
- Libro mayor: transacciones recientes: recargas (
deposit),spend,refundycreditconcedido.
La recarga pasa por la canalización de compra de pago (recarga desde la tarjeta del monedero); después, los agentes inscritos y los miembros gastan contra ese saldo compartido.
Panel de uso
GET /org/{orgId}/usage?window=day|month devuelve un desglose del gasto por
categoría (por reason) más el estado de los límites para el día o el mes UTC
actual (valor predeterminado: month). El detalle de uso es una vista de gestión
de la organización, así que está restringido a admin u owner. Úsalo para ver
a dónde van los créditos y cuánto le falta a la organización para llegar a sus
límites.
Límites de gasto
Los admin pueden limitar cuántos créditos gasta la organización por día y por
mes. Los límites se fijan mediante PATCH /org/{orgId}/spend-caps y los
aplica el Hub: es un límite real, no solo un indicador del panel:
PATCH /api/hub/org/{orgId}/spend-caps
{ "daily_cap_credits": 5000, "monthly_cap_credits": 100000 }
- Envía solo el campo que estás cambiando: una clave omitida deja ese límite sin cambios; enviar un valor vacío borra ese límite (sin límite).
- El cambio es idempotente y queda registrado en la auditoría del Hub.
- El panel de facturación muestra el uso diario/mensual frente a cada límite
(
spent / cap) con medidores de progreso, para que los miembros vean el margen restante.
Fijar límites requiere admin/owner; ver el uso frente a ellos forma parte del mismo panel de administración.
Roles. Cualquier persona de la organización puede ver el saldo del monedero. Recargar el monedero, ver el desglose de uso y fijar límites de gasto son acciones de admin/owner: el Hub lo aplica sin importar la interfaz.
Contenido relacionado
- Visión general de las organizaciones — roles y la consola
- Agentes y tokens de la organización — los agentes inscritos consumen de este monedero
- Visión general de la API — operaciones gratuitas frente a medidas y el modelo de créditos