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

---

​

Referencia rápida

---

Endpoints y opciones de configuración clave.

​

Endpoints

​

Tipos de limite

​

Campos de alcance