Transaktionsüberwachung Schnellstart: Setup in 10 Minuten

Richten Sie die Transaktionsüberwachung in weniger als 10 Minuten ein. Sie reichen eine Testtransaktion ein, prüfen deren Score, aktivieren eine voreingestellte Regel, reichen die Transaktion erneut ein, um die Auslösung zu sehen, und bestätigen, dass der Webhook eintrifft.

Voraussetzungen

Eine Didit-Anwendung mit aktivierter Transaktionsüberwachung (Settings → Transaction Monitoring → Enable).
Ein API-Schlüssel.
Ein Webhook-Endpoint, der aus dem Internet erreichbar ist.

Schritte

Eine Basistransaktion einreichen

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" }
  }'

Die Antwort enthält:

status: APPROVED, wenn keine Regeln ausgelöst wurden, IN_REVIEW oder DECLINED, wenn mindestens eine Regel ausgelöst wurde.
score: Ganzzahl von 0–100+.
rule_runs: Array mit allen Regeln, die diese Transaktion ausgewertet haben.

Eine voreingestellte Regel aktivieren

Navigieren Sie in der Business Console zu Transactions → Rules → Library. Wählen Sie eine voreingestellte Regel aus, zum Beispiel Structuring (outbound): Die Regel wird ausgelöst, wenn derselbe Benutzer innerhalb von 30 Tagen 20+ ausgehende Überweisungen unter 10.000 € sendet. Aktivieren Sie die Regel und speichern Sie.

Transaktionen einreichen, die die Regel auslösen

Reichen Sie 20 Transaktionen für denselben Benutzer in kurzer Folge ein, jeweils unter 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

Bei der 20. Einreichung wird die Structuring-Regel ausgelöst. Die Transaktion gibt status: IN_REVIEW zurück, und score spiegelt den score_delta der Regel wider.

Transaktions-Webhooks abonnieren

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"]
  }'

Die Antwort enthält secret_shared_key. Speichern Sie ihn sofort als DIDIT_WEBHOOK_SECRET in Ihrer .env:

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

Prüfen Sie danach bei jedem eingehenden Webhook den HMAC im Header X-Signature-V2, bevor Sie ihm vertrauen (berechnen Sie HMAC-SHA256 über den kanonisierten Body neu, vergleichen Sie in konstanter Zeit und weisen Sie veraltete Zeitstempel ab). Die Payloads und den vollständigen Verifizierungscode finden Sie unter TM-Webhooks.Jede weitere Transaktion wird in Echtzeit an Ihren Endpoint gesendet.

In der Konsole prüfen

Navigieren Sie in der Konsole zu Transactions:

Listenansicht: aktuelle Transaktionen, Filter, Massenaktionen.
Transaktionsdetails: Regelauswertungen, IP-Anreicherung, Angaben zu den Beteiligten, Netzwerkgraph (bei Krypto), verknüpfte Alerts und Fälle.

Eine Transaktion über die API abrufen

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

Gibt das vollständige Antwortschema zurück: Score, zutreffende Regeln, Anreicherung der Beteiligten, AML-Screening und mehr.

Was Sie gerade eingerichtet haben

Echtzeit-Scoring: Jede Transaktion durchläuft alle aktiven Regeln.
AML-Screening: Gegenparteien werden automatisch gegen Sanktionen / negative Medienberichte geprüft.
IP-Anreicherung: Jede Transaktion wird mit dem Land der IP-Adresse, ASN sowie VPN- und Tor-Kennzeichen angereichert.
Webhooks: Echtzeitbenachrichtigung zu jeder Transaktion.
Prüfpfad: Regelauswertungen, Alerts und Statusübergänge lassen sich in der Konsole abfragen.

Häufige nächste Schritte

Integrationsleitfaden

Vollständige Architektur und Muster.

Regeln im Detail

Wie Regeln funktionieren: Bedingungen, Aggregationen, Aktionen.

Risiko-Scoring

Wie Scores zu Status zusammengeführt werden.

Transaktions-Payload

Das vollständige Schema für die Einreichung von Transaktionen.

Status

Zustände von Transaktionen, Alerts und Fällen.

Fälle

Untersuchen und abschließen.

Erste Schritte

Funktionen

Referenz

Konsole

Transaktionsüberwachung Schnellstart: Setup in 10 Minuten

Voraussetzungen

Schritte

Was Sie gerade eingerichtet haben

Häufige nächste Schritte

Integrationsleitfaden

Regeln im Detail

Risiko-Scoring

Transaktions-Payload

Status

Fälle

​Voraussetzungen

​Schritte

​Was Sie gerade eingerichtet haben

​Häufige nächste Schritte

Integrationsleitfaden

Regeln im Detail

Risiko-Scoring

Transaktions-Payload

Status

Fälle

Voraussetzungen

Schritte

Was Sie gerade eingerichtet haben

Häufige nächste Schritte