Inici ràpid de monitoratge de transaccions: 10 min

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

Envia una transacció de referència

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

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.

Envia transaccions que activin la regla

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

Subscriu-te als webhooks de transaccions

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:

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 per als payloads i el codi de verificació complet.Cada transacció posterior s’enviarà al teu endpoint en temps real.

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.

Recupera una transacció via API

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

Retorna l’esquema de resposta 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

Guia d’integració

Arquitectura completa i patrons.

Anàlisi detallada de regles

Com funcionen les regles, les condicions, les agregacions i les accions.

Puntuació de risc

Com es combinen les puntuacions per formar estats.

Payload de transaccions

L’esquema complet d’enviament de transaccions.

Estats

Estats de transacció, alerta i cas.

Casos

Investiga i resol.

Primers passos

Funcionalitats

Referència

Consola

Inici ràpid de monitoratge de transaccions: 10 min

Prerequisits

Passos

Què acabes de configurar

Altres passos habituals

Guia d’integració

Anàlisi detallada de regles

Puntuació de risc

Payload de transaccions

Estats

Casos

​Prerequisits

​Passos

​Què acabes de configurar

​Altres passos habituals

Guia d’integració

Anàlisi detallada de regles

Puntuació de risc

Payload de transaccions

Estats

Casos

Prerequisits

Passos

Què acabes de configurar

Altres passos habituals