Enums

transaction_type

Valores permitidos (case-insensitive; se almacenan en mayúsculas):

Valor	Uso típico
`PAYIN`	Cobro / ingreso de fondos
`PAYOUT`	Desembolso
`RECURRING`	Cobro recurrente
`P2P`	Persona a persona
`TRANSFER`	Transferencia
`REVERSAL`	Reverso / chargeback
`CASHOUT`	Retiro de efectivo

payment_method

Valor	Notas
`CARD`	Tarjeta. Incluya `client_type` cuando aplique (WEB, POS, MOBILE_APP)
`BANK_TRANSFER`	Transferencia bancaria
`DIGITAL_WALLET`	Billetera digital
`PSE`	PSE (Colombia)
`BREB`	Bre-B instantáneo (Colombia)
`CASH`	Efectivo
`CRYPTO`	Criptoactivos

merchant_risk_tier

LOW, MEDIUM, HIGH — banda de riesgo precomputada de su plataforma para el comercio.

client_type (opcional)

WEB, WEB_BROWSER, MOBILE_APP, API, POS

fraud_type (feedback)

Obligatorio en POST /feedback cuando is_fraud=true. Omita el campo si is_fraud=false. Use el valor que mejor describa el caso después de confirmar fraude (investigación, chargeback, alerta de fraude, etc.):

Valor	Significado	Cuándo usarlo
`CARD_TESTING`	Prueba de tarjetas robadas	Microcargos o autorizaciones en serie para validar PANs antes de un cargo mayor
`ATO`	Account takeover — cuenta legítima comprometida	Acceso no autorizado: credenciales robadas, cambio abrupto de dispositivo/IP, sesión secuestrada
`MONEY_MULE`	Cuenta mulero	Cuenta que recibe fondos ilícitos y los reenvía o retira en poco tiempo
`SYNTHETIC_IDENTITY`	Identidad sintética	Perfil fabricado (datos reales mezclados con falsos) usado para abrir cuentas o acumular crédito
`FRIENDLY_FRAUD`	Fraude amistoso (first-party)	El titular niega un cargo que sí realizó o abusa del proceso de chargeback
`MERCHANT_COLLUSION`	Colusión con comercio	El comercio participa a sabiendas: transacciones ficticias, split de ganancias, procesamiento encubierto
`ACCOUNT_FARMING`	Cultivo de cuentas	Creación masiva o retención de cuentas inactivas para usarlas después en fraude
`LAUNDERING`	Lavado de dinero	Patrones para ocultar el origen de fondos: estructuración, round-tripping, capas de transferencias
`UNKNOWN`	Tipo no determinado	Fraude confirmado pero sin clasificación clara; use solo si ningún otro valor aplica

Si la transacción resultó legítima, envíe is_fraud=false y no incluya fraud_type.

risk_level (respuesta)

LOW, MEDIUM, HIGH, CRITICAL

decision (respuesta)

Valor	Significado
`APPROVE`	Aceptar automáticamente
`REVIEW`	Enviar a revisión manual
`REJECT`	Bloquear

decision_source (respuesta)

Valores expuestos al cliente: MODEL, RULES, FALLBACK.

Kairo Connect

Kairo Shield — Introducción

Kairo Shield — Comenzando

Kairo Shield — API

Kairo Shield — Referencia

Kairo Shield — Webhooks

Kairo Shield — Resumen

transaction_type

payment_method

merchant_risk_tier

client_type (opcional)

fraud_type (feedback)

risk_level (respuesta)

decision (respuesta)

decision_source (respuesta)

​transaction_type

​payment_method

​merchant_risk_tier

​client_type (opcional)

​fraud_type (feedback)

​risk_level (respuesta)

​decision (respuesta)

​decision_source (respuesta)

transaction_type

payment_method

merchant_risk_tier

client_type (opcional)

fraud_type (feedback)

risk_level (respuesta)

decision (respuesta)

decision_source (respuesta)