> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitorización de transacciones: inicio rápido

> Envía tu primera transacción, mira cómo se activan las reglas y conecta webhooks en menos de 10 minutos. $0.02 por transacción, sin contratos.

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

**1. Enviar una transacción de referencia**

```bash theme={null}
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.

**2. 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.

**3. Enviar transacciones que activen la regla**

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

```bash theme={null}
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.

**4. Suscribirte a los webhooks de transacciones**

```bash theme={null}
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`:

```bash theme={null}
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](https://docs.didit.me/transaction-monitoring/webhooks.md) 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.

**5. 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.

**6. Recuperar una transacción mediante la API**

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

Devuelve el [esquema de respuesta](https://docs.didit.me/transaction-monitoring/response-schema.md) 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](https://docs.didit.me/transaction-monitoring/integration-guide.md)**
>
> Arquitectura y patrones completos.

> **[Reglas en profundidad](https://docs.didit.me/transaction-monitoring/rules.md)**
>
> Cómo funcionan las reglas, condiciones, agregaciones y acciones.

> **[Puntuación de riesgo](https://docs.didit.me/transaction-monitoring/risk-scoring.md)**
>
> Cómo se combinan las puntuaciones en estados.

> **[Payload de transacciones](https://docs.didit.me/transaction-monitoring/transactions.md)**
>
> El esquema completo de envío de transacciones.

> **[Estados](https://docs.didit.me/transaction-monitoring/statuses.md)**
>
> Estados de transacciones, alertas y casos.

> **[Casos](https://docs.didit.me/transaction-monitoring/cases.md)**
>
> Investiga y resuelve.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.