Monitorización de transacciones: inicio rápido

Pon en marcha la monitorización de transacciones de Didit en menos de 10 minutos. Enviarás una transacción de prueba, inspeccionarás su puntuación, activarás una regla predefinida, volverás a enviar para ver cómo se activa y confirmarás que llega el webhook.

Requisitos previos

Una aplicación de Didit con la monitorización de transacciones habilitada (Configuración → Monitoreo de transacciones → Habilitar).
Una clave de API.
Un endpoint de webhook accesible desde internet.

Pasos

Enviar una transacción de referencia

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'

La respuesta incluye:

status: APPROVED si no se activó ninguna regla, IN_REVIEW / DECLINED si se activó alguna.
score: número entero de 0 a 100+.
rule_runs: arreglo con todas las reglas que evaluaron esta transacción.

Activar una regla predefinida

Ve a Transacciones → Reglas → Biblioteca en la Business Console. Elige una regla predefinida, por ejemplo Structuring (outbound): se activa cuando el mismo usuario envía 20+ transferencias salientes por debajo de €10,000 en 30 días. Actívala y guarda.

Enviar transacciones que activen la regla

Envía 20 transacciones seguidas del mismo usuario, cada una por debajo de €10,000:

for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done

En el envío número 20 se activa la regla Structuring. La transacción devuelve status: IN_REVIEW y score refleja el score_delta de la regla.

Suscribirte a los webhooks de transacciones

curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'

La respuesta incluye secret_shared_key: guárdala de inmediato como DIDIT_WEBHOOK_SECRET en tu .env:

DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration

Después, verifica el HMAC X-Signature-V2 de cada webhook entrante antes de fiarte de él (recalcula HMAC-SHA256 sobre el cuerpo canonicalizado, compáralo en tiempo constante y rechaza las marcas de tiempo caducadas). Consulta los webhooks de monitorización de transacciones para ver los payloads y el código de verificación completo.A partir de ahí, cada transacción se envía a tu endpoint en tiempo real.

Inspeccionar en la consola

Ve a Transacciones en la consola:

Vista de lista: transacciones recientes, filtros y acciones masivas.
Detalle de la transacción: ejecuciones de reglas, enriquecimiento de IP, datos de las partes, grafo de red (para cripto), alertas y casos vinculados.

Recuperar una transacción mediante la API

curl https://verification.didit.me/v3/transactions/{transaction_id}/ \
  -H "x-api-key: YOUR_API_KEY"

Devuelve el esquema de respuesta completo: puntuación, reglas activadas, enriquecimiento de las partes, análisis AML y más.

Lo que acabas de configurar

Puntuación en tiempo real: cada transacción pasa por todas las reglas activas.
Análisis AML: las contrapartes se analizan automáticamente en listas de sanciones y noticias negativas.
Enriquecimiento de IP: cada transacción se enriquece con el país de la IP, el ASN y los indicadores de VPN/Tor.
Webhooks: notificación en tiempo real de cada transacción.
Registro de auditoría: las ejecuciones de reglas, las alertas y las transiciones de estado se pueden consultar en la consola.

Próximos pasos habituales

Guía de integración

Arquitectura y patrones completos.

Reglas en profundidad

Cómo funcionan las reglas, condiciones, agregaciones y acciones.

Puntuación de riesgo

Cómo se combinan las puntuaciones en estados.

Payload de transacciones

El esquema completo de envío de transacciones.

Estados

Estados de transacciones, alertas y casos.

Casos

Investiga y resuelve.

​Requisitos previos

​Pasos

​Lo que acabas de configurar

​Próximos pasos habituales