Límites y velocity
Caps por transacción, por día, por mes y límite de pánico de 24h.
Los límites de un agente viven en approvalConfig y se resuelven al momento de cada pago
(collectLimitBreaches), sumando gastos liquidados más holds en vuelo.
Tipos de límite
Campo (approvalConfig) | limitType en el breach | Ventana |
|---|---|---|
per_transaction_cents | perTransactionAmount | Pago individual |
per_day_cents | dailyAmount | Día calendario (zona AR) |
per_month_cents | monthlyAmount | Mes calendario (zona AR) |
panic_limit_24h_cents | — | Ventana móvil de 24h |
Todos los montos son centavos (enteros). La ventana diaria/mensual usa la zona horaria de Argentina, no UTC.
Herencia
Si approvalConfig de un sub-wallet es null, el agente hereda la config del padre.
No es "gana el más restrictivo" entre niveles: es override o herencia.
Límite de pánico (24h)
panic_limit_24h_cents es un freno duro sobre cualquier ventana móvil de 24h,
independiente del día/mes calendario. Es un control que la mayoría de los competidores no
tiene: sirve para contener un agente que se descarrila sin esperar al corte de día.
Qué pasa al superar un cap
No hay rechazo: se crea un approval y la plata no se mueve. Ver Approvals.
Paridad entre superficies: hoy collectLimitBreaches corre en el MCP (wallet_pay
y pagos programados). El path de WhatsApp aún crea el approval sin pasar por velocity,
y la API REST no lo aplica todavía. Cerrar esa brecha es trabajo en curso.