Vision general del cumplimiento
Tracer esta disenado para cumplir con los requisitos de auditoria de regulaciones financieras incluyendo:
| Regulacion | Requisito | Como Tracer cumple |
|---|---|---|
| SOX (Sarbanes-Oxley) | Rastro de auditoria completo de decisiones financieras | Cada validacion se registra con contexto completo |
| GLBA (Gramm-Leach-Bliley) | Proteccion de datos financieros del cliente | Datos encriptados en reposo y en transito |
| Auditoria general | Capacidad de reconstruir decisiones | Registros inmutables con instantaneas de entrada/salida |
Arquitectura del rastro de auditoría
Tracer registra cada decisión de validación con contexto completo para cumplimiento e investigación.
Qué se registra
Cada validacion crea un registro de auditoria inmutable que contiene:| Dato | Descripcion |
|---|---|
| Instantanea de solicitud | Payload de entrada completo como se recibio |
| Instantanea de respuesta | Respuesta completa incluyendo decision y detalles |
| Decision | ALLOW, DENY o REVIEW |
| Motivo | Por que se tomo la decision |
| Reglas evaluadas | Todas las reglas que fueron evaluadas |
| Reglas coincidentes | Reglas que se dispararon (si las hay) |
| Detalles de limites | Informacion de uso para los limites verificados |
| Tiempo de procesamiento | Cuanto tomo la validacion |
| Marca de tiempo | Cuando ocurrio la validacion |
Garantias de inmutabilidad
Los registros de auditoria son de escritura unica:- Los registros no pueden modificarse despues de la creacion
- Los registros no pueden eliminarse (excepto por politica de retencion)
- Cada registro tiene un ID de validacion unico para referencia
El rastro de auditoria esta disenado para auditorias de cumplimiento. Puedes reconstruir exactamente lo que sucedio para cualquier validacion, incluso anos despues.
Retención de datos
Tracer retiene datos según los requisitos regulatorios y las necesidades operativas.
Períodos de retención
| Tipo de dato | Periodo de retencion | Motivo |
|---|---|---|
| Registros de validacion | 7 anos minimo | Requisito de cumplimiento SOX/GLBA |
| Reglas (activas/inactivas) | Indefinido | Continuidad operacional |
| Reglas (eliminadas) | No se retienen | Eliminadas permanentemente |
| Limites | Indefinido | Continuidad operacional |
| Logs de aplicacion | 90 dias | Depuracion y resolucion de problemas |
Consideraciones de cumplimiento
- Requisito SOX: Mantener registros por 7 anos desde la fecha del informe de auditoria
- Requisito GLBA: Retener registros que demuestren cumplimiento con las reglas de privacidad
- Exportacion de datos: Los registros pueden exportarse para sistemas de auditoria externos
Consultando el historial de validaciones
Usa el endpoint
GET /v1/validations para consultar validaciones historicas.
Consulta basica
Consulta filtrada
Filtros disponibles
| Parametro | Tipo | Descripcion |
|---|---|---|
startDate | RFC3339 | Inicio del rango de fechas (inclusivo) |
endDate | RFC3339 | Fin del rango de fechas (exclusivo) |
decision | enum | Filtrar por ALLOW, DENY o REVIEW |
accountId | UUID | Filtrar por cuenta |
segmentId | UUID | Filtrar por segmento |
portfolioId | UUID | Filtrar por portafolio |
transactionType | enum | Filtrar por CARD, WIRE, PIX, CRYPTO |
matchedRuleId | UUID | Filtrar por regla que coincidio |
exceededLimitId | UUID | Filtrar por limite que fue excedido |
Requisito de formato de fecha
Valido:Paginación
Los resultados usan paginación basada en cursor. La respuesta incluye camposnextCursor y hasMore para navegar a través de los resultados.
| Parámetro | Predeterminado | Máximo | Descripción |
|---|---|---|---|
limit | 100 | 1000 | Resultados por página |
cursor | - | - | Cursor de paginación de la respuesta anterior |
Al usar paginación con cursor,
sortBy y sortOrder se fijan desde la consulta original.Ordenamiento
| Parametro | Opciones | Predeterminado |
|---|---|---|
sortBy | createdAt, processingTimeMs | createdAt |
sortOrder | ASC, DESC | DESC |
Obteniendo detalles de validación
Recupera detalles completos para una validación específica usando
GET /v1/validations/{validationId}.
La respuesta contiene todo lo necesario para entender una decisión de validación:
- Instantánea de solicitud: El payload de entrada completo como se recibió
- Instantánea de respuesta: Respuesta completa incluyendo decisión y motivo
- Reglas evaluadas: Todas las reglas que fueron verificadas
- Reglas coincidentes: Reglas que se dispararon (si las hay)
- Detalles de límites: Información de uso para los límites verificados
- Timestamps: Cuándo ocurrió la validación y tiempo de procesamiento
Escenarios de informes de cumplimiento
Consultas comunes para informes de auditoría y cumplimiento.
Escenario 1: Investigación de auditoría
“Por que fue denegada esta transaccion el 15 de enero?”Escenario 2: Informe de cumplimiento mensual
“Mostrar todas las transacciones denegadas para cuentas corporativas en enero”Escenario 3: Analisis de efectividad de reglas
“Que transacciones fueron denegadas por una regla de fraude especifica?”Escenario 4: Revision de utilizacion de limites
“Que transacciones excedieron limites de gasto este mes?”Mejores prácticas para cumplimiento
Recomendaciones para mantener la preparación para auditorías.
Mantenimiento de registros
- Almacena los IDs de validacion en tus registros de transacciones para facil referencia cruzada
- Registra el requestId que envias a Tracer para correlacion
- Exporta regularmente si necesitas registros en sistemas de auditoria externos
Preparacion para auditoria
- Prueba las consultas antes de la temporada de auditorias para asegurar que puedes recuperar los datos necesarios
- Verifica los rangos de fechas funcionen correctamente con tus requisitos de zona horaria
- Documenta tu politica de retencion alineada con la retencion de 7 anos de Tracer
Flujo de trabajo de investigacion
Al investigar una transaccion especifica:- Encuentra el ID de validacion desde tus logs de transacciones o el historial de Tracer
- Recupera los detalles completos usando GET /v1/validations/
- Revisa la instantanea de la solicitud para ver que datos fueron proporcionados
- Verifica las reglas coincidentes para entender por que se tomo la decision
- Verifica el estado de los limites si los limites estuvieron involucrados
Comportamiento fail-open y auditoria
Tracer usa un enfoque fail-open configurable por defecto:
| Escenario | Comportamiento predeterminado | Registro de auditoria |
|---|---|---|
| Ninguna regla coincide | ALLOW | Registrado con motivo “no_match” |
| Base de datos temporalmente no disponible | ALLOW con advertencia | Registrado si es posible; alerta generada |
| Tiempo de espera de evaluacion | ALLOW con advertencia | Registrado con motivo “timeout” |
El comportamiento fail-open puede configurarse a fail-closed para entornos de alta seguridad. Contacta a tu administrador para opciones de configuracion.
Referencia rápida
Endpoints clave e información de retención.
Endpoints
| Operación | Método | Endpoint |
|---|---|---|
| Listar validaciones | GET | /v1/validations |
| Obtener validación | GET | /v1/validations/{validationId} |
Resumen de retención
| Dato | Retencion |
|---|---|
| Registros de validacion | 7+ anos |
| Reglas/limites activos | Indefinido |
| Logs de aplicacion | 90 dias |