Reportar fraude

Reporta fraude contra tu host API asignado ($CLAUSUM_API_BASE). Consulta Acceso y entornos.

Cuando el fraude está confirmado — llega un chargeback, se detecta account takeover, o tu equipo confirma un expediente — repórtalo a Clausum con una sola llamada. Clausum hace el trabajo pesado automáticamente.

Qué ocurre al reportar

Transacción marcada

La transacción coincidente se marca is_fraudulent con el motivo y marca de tiempo.

Expediente abierto

Se crea un expediente con reference_number generado, prioridad derivada de monto y motivo, y tipo de incidente mapeado.

Blocklists actualizadas

El correo ofensor (block), BIN de tarjeta (flag, para card testing / friendly fraud) e IP (block) se agregan a tus blocklists y se vinculan al expediente.

Cadena notificada

Alertas por correo van a los participantes configurados (comercio, adquirente, emisor, compliance) y se dispara el webhook fraud.detected.

Autenticación

Requiere una clave secreta con permiso fraud:report.

Authorization: Bearer clm_sk_xxx

Identificar la transacción

Proporciona uno de estos para referenciar una transacción existente:

transaction_id — UUID interno de transacción Clausum.
payment_id + provider — p. ej. pi_3Nxyz + stripe (mismo id que assess payment_id).
external_transaction_id + provider — alias deprecado de payment_id.

Si aún no existe transacción, proporciona datos inline suficientes (amount + email) y Clausum crea una.

Ejemplos

curl -X POST "$CLAUSUM_API_BASE/api/v1/report-fraud" \
  -H "Authorization: Bearer $CLAUSUM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_transaction_id": "pi_3Nxyz",
    "provider": "stripe",
    "reason": "chargeback",
    "description": "Issuer chargeback, reason code 10.4",
    "ip_address": "201.150.10.22"
  }'

curl -X POST "$CLAUSUM_API_BASE/api/v1/report-fraud" \
  -H "Authorization: Bearer $CLAUSUM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 89900,
    "currency": "USD",
    "email": "fraudster@example.com",
    "card_bin": "411111",
    "card_last4": "4242",
    "reason": "card_testing"
  }'

Motivos

`reason`	Usar para
`chargeback`	Chargeback / disputa del emisor
`friendly_fraud`	Titular legítimo reclamando fraude
`card_testing`	Transacciones pequeñas de prueba para validar tarjetas robadas
`account_takeover`	Cuenta de cliente comprometida
`identity_theft`	Identidad robada usada para transaccionar
`other`	Cualquier otro caso

Controlar notificaciones

Usa el objeto notify para decidir qué partes reciben alerta. Adjunta evidencia con evidence_urls.

{
  "external_transaction_id": "pi_3Nxyz",
  "provider": "stripe",
  "reason": "chargeback",
  "evidence_urls": ["https://files.example.com/chargeback.pdf"],
  "notify": { "merchant": true, "acquirer": true, "issuer": true, "compliance": true }
}

Respuesta

{
  "success": true,
  "data": {
    "case": { "id": "b1f2...", "reference_number": "CLM-LX9A2B", "status": "received", "priority": "high" },
    "transaction": { "id": "txn_123", "external_id": "pi_3Nxyz", "is_fraudulent": true },
    "blocklist": { "entries_added": 2, "types": ["email", "ip"] }
  }
}

Tras reportar, las nuevas entradas de blocklist entran en vigor de inmediato — el mismo correo, BIN o IP se evaluará contra ellas en la próxima llamada /assess.

Primeros pasos

Integración por tipo de cliente

Soluciones y prevención

Capacidades — eventos y operaciones

Panel de control

Conceptos clave

Referencia

Reportar fraude

Qué ocurre al reportar

Autenticación

Identificar la transacción

Ejemplos

Motivos

Controlar notificaciones

Respuesta

​Qué ocurre al reportar

​Autenticación

​Identificar la transacción

​Ejemplos

​Motivos

​Controlar notificaciones

​Respuesta

Qué ocurre al reportar

Autenticación

Identificar la transacción

Ejemplos

Motivos

Controlar notificaciones

Respuesta