> ## 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.

# Inici ràpid de monitoratge de transaccions: 10 min

> Amb Didit, envia una transacció, activa regles i configura webhooks en 10 minuts. 1,000 transaccions al mes incloses; després, $0.001 cadascuna.

Posa en marxa el Monitoratge de transaccions en menys de 10 minuts. Enviaràs una transacció de prova, inspeccionaràs la seva puntuació, activaràs una regla predefinida, tornaràs a enviar la transacció per veure que la regla s'activa i confirmaràs que el webhook arriba.

## Prerequisits

* Una aplicació de Didit amb el Monitoratge de transaccions activat (*Settings → Transaction Monitoring → Enable*).
* Una clau d'API.
* Un endpoint de webhook accessible des d'internet.

## Passos

**1. Envia una transacció de referència**

```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 resposta inclou:

* `status` — `APPROVED` si no s'ha activat cap regla, `IN_REVIEW` / `DECLINED` si n'ha activat alguna.
* `score` — enter de 0 a 100+.
* `rule_runs` — matriu de totes les regles que han avaluat aquesta transacció.

**2. Activa una regla predefinida**

Navega a *Transactions → Rules → Library* a la Business Console. Tria una regla predefinida, per exemple **Structuring (outbound)**: s'activa quan el mateix usuari envia 20+ transferències sortints per sota de 10.000 € en 30 dies. Activa-la i desa els canvis.

**3. Envia transaccions que activin la regla**

Envia 20 transaccions ràpidament per al mateix usuari, cadascuna per sota 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 la vintena transacció, s'activa la regla Structuring. La transacció retorna `status: IN_REVIEW` i `score` reflecteix el `score_delta` de la regla.

**4. Subscriu-te als webhooks de transaccions**

```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 resposta inclou `secret_shared_key`. Desa-la immediatament com a `DIDIT_WEBHOOK_SECRET` al teu `.env`:

```bash theme={null}
DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration
```

A continuació, verifica la capçalera HMAC `X-Signature-V2` de cada webhook entrant abans de confiar-hi (recalcula HMAC-SHA256 sobre el cos canonicalitzat, fes una comparació en temps constant i rebutja les marques de temps obsoletes). Consulta [webhooks de TM](https://docs.didit.me/ca/transaction-monitoring/webhooks.md) per als payloads i el codi de verificació complet.

Cada transacció posterior s'enviarà al teu endpoint en temps real.

**5. Inspecciona-ho a la consola**

Navega a *Transactions* a la consola:

* Vista de llista: transaccions recents, filtres i accions en lot.
* Detall de la transacció: execucions de regles, enriquiment d'IP, dades de les parts, graf de xarxa (per a criptoactius), alertes i casos vinculats.

**6. Recupera una transacció via API**

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

Retorna l'[esquema de resposta](https://docs.didit.me/ca/transaction-monitoring/response-schema.md) complet: puntuació, regles coincidents, enriquiment de les parts, cribratge AML i més.

## Què acabes de configurar

* **Puntuació en temps real**: cada transacció passa per totes les regles actives.
* **Cribratge AML**: les contraparts es cribren automàticament contra llistes de sancions i mitjans adversos.
* **Enriquiment d'IP**: cada transacció s'enriqueix amb el país de la IP, l'ASN i les marques de VPN/Tor.
* **Webhooks**: notificació en temps real de cada transacció.
* **Registre d’auditoria**: les execucions de regles, les alertes i les transicions d'estat es poden consultar a la consola.

## Altres passos habituals

> [card] [Guia d’integració](https://docs.didit.me/ca/transaction-monitoring/integration-guide.md)
>
> Arquitectura completa i patrons.

> [card] [Anàlisi detallada de regles](https://docs.didit.me/ca/transaction-monitoring/rules.md)
>
> Com funcionen les regles, les condicions, les agregacions i les accions.

> [card] [Puntuació de risc](https://docs.didit.me/ca/transaction-monitoring/risk-scoring.md)
>
> Com es combinen les puntuacions per formar estats.

> [card] [Payload de transaccions](https://docs.didit.me/ca/transaction-monitoring/transactions.md)
>
> L'esquema complet d'enviament de transaccions.

> [card] [Estats](https://docs.didit.me/ca/transaction-monitoring/statuses.md)
>
> Estats de transacció, alerta i cas.

> [card] [Casos](https://docs.didit.me/ca/transaction-monitoring/cases.md)
>
> Investiga i resol.


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