Eventos de webhook

Evento	Cuándo se envía
`transaction.scored`	Transacción evaluada con riesgo bajo/medio (decisión estándar)
`transaction.high_risk`	Transacción con riesgo alto o decisión REVIEW por score
`transaction.blocked`	Transacción bloqueada (decisión REJECT)
`alert.created`	Se creó una alerta de fraude en el portal
`alert.status_changed`	Cambió el estado de una alerta
`alert.escalated`	Alerta escalada
`feedback.received`	Se registró feedback confirmado vía API

Evento

Cuándo se envía

transaction.scored

Transacción evaluada con riesgo bajo/medio (decisión estándar)

transaction.high_risk

Transacción con riesgo alto o decisión REVIEW por score

transaction.blocked

Transacción bloqueada (decisión REJECT)

alert.created

Se creó una alerta de fraude en el portal

alert.status_changed

Cambió el estado de una alerta

alert.escalated

Alerta escalada

feedback.received

Se registró feedback confirmado vía API

Por cada transacción evaluada se emite un solo evento de transacción: el más específico disponible (blocked → high_risk → scored). Si está suscrito a varios, igual recibe un único POST por score.

Encabezado	Descripción
`Content-Type`	`application/json`
`X-Kairo-Signature`	`sha256={HMAC-SHA256 del body raw}`
`X-Kairo-Event`	Nombre del evento
`X-Kairo-Delivery`	ID único del envío
`X-Kairo-Timestamp`	Marca de tiempo ISO 8601 UTC

Encabezado

Descripción

Content-Type

application/json

X-Kairo-Signature

sha256={HMAC-SHA256 del body raw}

X-Kairo-Event

Nombre del evento

X-Kairo-Delivery

ID único del envío

X-Kairo-Timestamp

Marca de tiempo ISO 8601 UTC

Ejemplo — transaction.scored

{
  "event": "transaction.scored",
  "timestamp": "2025-06-15T14:30:00Z",
  "data": {
    "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
    "client_id": "fintech_a",
    "fraud_score": 0.15,
    "risk_level": "LOW",
    "decision": "APPROVE",
    "decision_source": "MODEL",
    "model_version": "kairo-shield",
    "threshold_used": {"low_max": 0.25, "medium_max": 0.55, "high_max": 0.80},
    "scored_at": "2025-06-15T14:30:01Z"
  }
}

Los reintentos usen backoff exponencial según la retry_policy configurada (o valores por defecto de plataforma).

Kairo Connect

Kairo Shield — Introducción

Kairo Shield — Comenzando

Kairo Shield — API

Kairo Shield — Referencia

Kairo Shield — Webhooks

Kairo Shield — Resumen

Encabezados de entrega

Ejemplo — transaction.scored

​Encabezados de entrega

​Ejemplo — transaction.scored

Encabezados de entrega

Ejemplo — transaction.scored