Limites de gasto

Los limites de gasto en Tracer te permiten controlar los montos de transaccion por alcance (cuenta, portafolio, segmento) y periodo (diario, mensual, por transaccion). Los limites se evaluan en tiempo real junto con las reglas, proporcionando una gobernanza integral de transacciones.

​

Por qué usar límites de gasto

---

• Protección del cliente: Detecta el gasto excesivo y devuelve decisiones DENY para transacciones grandes no autorizadas
• Gestión de riesgo: Monitorea la exposición por cuenta, segmento o portafolio
• Alcance flexible: Aplica límites en diferentes niveles de granularidad
• Seguimiento en tiempo real: Monitorea el uso y los montos restantes instantáneamente
• Reinicios automáticos: Los límites diarios y mensuales se reinician automáticamente

Al final de esta guia, podras:

• Comprender los tipos de limites y opciones de alcance
• Crear y configurar limites de gasto
• Monitorear el uso de limites en tiempo real
• Gestionar el ciclo de vida de los limites

​

Conceptos principales

---

Comprende los componentes básicos de los límites de gasto.

​

Tipos de límites

Tracer soporta tres tipos de limites de gasto:

​

Alcances

Los alcances definen a que transacciones se aplica un limite. Un limite coincide con transacciones que encajan dentro de su definicion de alcance. Campos de alcance (todos opcionales, al menos uno requerido):

• segmentId - Aplicar a transacciones de un segmento especifico
• portfolioId - Aplicar a transacciones de un portafolio especifico
• accountId - Aplicar a transacciones de una cuenta especifica
• merchantId - Aplicar a transacciones hacia un comercio especifico
• transactionType - Aplicar a tipos de transaccion especificos (CARD, WIRE, PIX, CRYPTO)

Jerarquia de alcance: Los alcances mas especificos tienen precedencia. Por ejemplo, un limite a nivel de cuenta es mas especifico que un limite a nivel de segmento.

​

Seguimiento de uso

Para limites DAILY y MONTHLY, Tracer rastrea:

• Uso actual - Monto total consumido en el periodo actual (en la unidad mas pequena de la moneda)
• Porcentaje de utilizacion - Porcentaje del limite usado
• Tiempo de reinicio - Cuando el limite se reiniciara a cero

​

Cómo funcionan los límites

---

Tracer evalúa los límites durante cada solicitud de validación.

​

Flujo de verificación de límites

Cuando se valida una transacción, Tracer verifica todos los límites aplicables:

1. Encontrar limites - Consultar todos los limites activos que coinciden con el alcance de la transaccion
2. Calcular uso proyectado - Agregar el monto de la transaccion al uso actual
3. Comparar umbral - Verificar si el uso proyectado excede el monto del limite
4. Devolver resultado - Devuelve decision DENY si algun limite es excedido (tu sistema debe entonces bloquear la transaccion)

​

Escenario de ejemplo

Un segmento corporativo tiene un límite diario de R$ 50.000 (5.000.000 centavos) para transacciones CARD. Si el uso actual es R$45.000 y llega una nueva transacción de R$ 8.000:

• Uso proyectado: R$45.000 + R$ 8.000 = R$ 53.000
• Límite: R$ 50.000
• Resultado: Tracer devuelve DENY (tu sistema debe bloquear la transacción)

​

Crear un límite

---

Crea límites usando POST /v1/limits. Los límites se crean en estado DRAFT por defecto. Un límite requiere:

• name: Un nombre descriptivo (ej.: “Límite Diario Tarjeta Corporativa”)
• limitType: DAILY, MONTHLY o PER_TRANSACTION
• maxAmount: Monto máximo en la unidad más pequeña de la moneda
• currency: Código de moneda ISO 4217 (ej.: BRL, USD)
• scopes: Al menos un alcance para definir a qué transacciones se aplica

Para la estructura completa del payload y detalles de campos, consulta la Referencia de API.

​

Consultar uso del límite

---

Monitorea el consumo del límite usando GET /v1/limits/{limitId}/usage. La respuesta incluye:

• currentUsage: Monto consumido en el período actual
• utilizationPercent: Porcentaje del límite utilizado
• nearLimit: True cuando el uso excede el 80% (para gestión proactiva)
• resetAt: Cuándo se reinicia el límite (solo DAILY/MONTHLY)

​

Actualizar un límite

---

Actualiza límites usando PATCH /v1/limits/{limitId}. Los campos limitType y currency son inmutables y no pueden cambiarse después de la creación.

​

Ciclo de vida de los limites

---

Los limites siguen el mismo ciclo de vida que las reglas:

​

Estados

​

Transiciones

​

Mejores prácticas

---

Recomendaciones para gestión efectiva de límites.

​

Nomenclatura

• Se descriptivo - Incluye el alcance y tipo en el nombre
• Usa patrones consistentes - ej., “Daily Limit”

​

Diseno de alcance

• Comienza amplio, refina segun sea necesario - Comienza con limites a nivel de segmento, agrega a nivel de cuenta para excepciones
• Evita alcances superpuestos - Multiples limites en el mismo alcance pueden causar confusion
• Usa tipos de transaccion - Diferentes metodos de pago pueden necesitar diferentes limites

​

Monitoreo

• Observa las banderas nearLimit - Contacta proactivamente a los clientes que se acercan a los limites
• Revisa las transacciones denegadas - Tasas altas de denegacion pueden indicar limites demasiado restrictivos
• Ajusta estacionalmente - Considera aumentos temporales de limites durante periodos de alto gasto

​

Confiabilidad y aplicación

---

Los límites de gasto en Tracer están diseñados para entornos de producción donde la precisión y la confianza son innegociables.

​

Evaluación atómica

Las verificaciones de límites se realizan de forma atómica. Cuando se valida una transacción, Tracer lee el uso actual y evalúa el límite en una sola operación indivisible. Esto significa que incluso cuando múltiples transacciones llegan simultáneamente para la misma cuenta o alcance, cada evaluación refleja el estado real del uso en ese momento. No hay ventana en la que transacciones concurrentes puedan eludir un límite. Si dos transacciones llegan al mismo tiempo y solo una cabe dentro del presupuesto restante, exactamente una es aprobada.

​

Marcas de tiempo del servidor

Todo el seguimiento de uso se basa en marcas de tiempo del servidor generadas por Tracer. Los clientes no pueden influir en cuándo se registra una transacción o cuándo se reinicia un período. Esto elimina cualquier posibilidad de que la manipulación de marcas de tiempo afecte los cálculos de límites.

​

Qué significa esto en la práctica

• Seguridad concurrente: Los entornos de alto rendimiento con muchas transacciones simultáneas por cuenta son completamente soportados. Los límites se comportan correctamente bajo carga.
• Seguimiento preciso: Los totales de uso siempre reflejan el estado real, incluso durante picos de tráfico.
• Reinicios confiables: Los reinicios diarios y mensuales ocurren basándose en el reloj interno de Tracer, no en tiempos reportados por el cliente.

​

Referencia rápida

---

Endpoints y opciones de configuración clave.

​

Endpoints

​

Tipos de limite

​

Campos de alcance