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

# Transaktionsverlauf von Benutzern: KYT & Risiko

> Didit: Transaktionsverlauf eines Benutzers abrufen und in Transaktionsüberwachung einbeziehen. 1,000 pro Monat inklusive, danach $0.001 je Aufruf.

Jede Transaktion, die Sie mit einer `vendor_data`-Kennung übermitteln (als Antragsteller oder als Gegenpartei), wird mit der entsprechenden Benutzerentität verknüpft. Das Benutzerprofil wird dadurch zu einem fortlaufenden Journal der Aktivitäten dieser Person, und Transaktionsüberwachung nutzt diesen Verlauf für Velocity- und Verhaltensregeln.

## Transaktionen eines Benutzers abrufen

Filtern Sie die Transaktionsliste nach `vendor_data`:

```bash theme={null}
curl -G https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"
```

Gibt alle Transaktionen zurück, in denen der Benutzer der Antragsteller ist. Für den Verlauf auf Seite der Gegenpartei filtern Sie in der Business Console (der öffentliche Listen-Endpoint filtert nur nach Antragsteller).

## So werden Transaktionen mit Benutzern verknüpft

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0001"]
    A["applicant:<br/>vendor_data=user-42"]
    C["counterparty:<br/>vendor_data=user-99"]
    U1[User: user-42]
    U2[User: user-99]
    T --> A
    T --> C
    A -.-> U1
    C -.-> U2
```

Jede Transaktion enthält bis zu vier Beteiligte (Antragsteller, Auftraggeber, Begünstigter, Gegenpartei). Wenn ein Beteiligter `vendor_data` enthält, ordnet Didit ihn diesem Benutzer zu. Beteiligte ohne `vendor_data` werden als externe Snapshots gespeichert, ohne Verknüpfung zu einer Entity.

Das vollständige Beteiligtenmodell finden Sie unter [Transaktionen übermitteln](https://docs.didit.me/de/transaction-monitoring/transactions.md).

## Aggregierte Risikosignale

Transaktionen fließen in die folgenden benutzerbezogenen Signale ein:

| Signal | Verwendet von |
| - | - |
| Gesamtvolumen eingehend / ausgehend | Velocity-Regeln, Schwellenwert-Auswertung |
| Anzahl der Transaktionen in einem Zeitfenster | Velocity-Regeln |
| Eindeutige Gegenparteien | Verhaltensregeln |
| Betroffene Hochrisiko-Jurisdiktionen | Geografische Regeln |
| Exposition gegenüber sanktionierten Gegenparteien | Screening-Regeln |
| Vielfalt der Zahlungsmethoden | Betrugsregeln |

Diese Signale werden in Echtzeit berechnet und gegen Ihre aktiven [Transaktionsregeln](https://docs.didit.me/de/transaction-monitoring/rules.md) ausgewertet. Wenn eine Regel zutrifft, kann der Benutzer je nach Aktion der Regel automatisch auf `FLAGGED` oder `BLOCKED` gesetzt werden.

## So wirken Regeln auf Benutzer

Die `actions` einer Transaktionsregel können Folgendes enthalten:

* `add_score`: erhöht den Risiko-Score der Transaktion.
* `change_status`: setzt den Status der Transaktion (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: markiert die Transaktion mit Tags.
* `add_to_list`: fügt die `vendor_data` des Benutzers einer Sperrliste oder einer benutzerdefinierten Liste hinzu.

Wenn eine Regel den Benutzer einer Sperrliste hinzufügt, wird seine Benutzerentität auf `BLOCKED` gesetzt und ein Webhook `user.status.updated` ausgelöst.

## Verhalten eines Benutzers überwachen

Verwenden Sie die Registerkarte „Transaktionen“ auf der Detailseite des Benutzers in der Business Console, um:

* jede Transaktion in chronologischer Reihenfolge anzuzeigen.
* nach Status, Betrag, Richtung und Gegenpartei zu filtern.
* jede Transaktion zu öffnen und Regelausführungen, IP-Anreicherung und Ergebnisse des Krypto-Screenings zu prüfen.
* einen Fall gegen den Benutzer zu eröffnen, um eine Untersuchung zu verfolgen.

## Remediation-Sessions

Wenn eine Transaktion in `AWAITING_USER` übergeht, erstellt Didit eine verknüpfte **Remediation-Session**, in der der Benutzer zusätzliche Verifizierungen abschließen muss (zum Beispiel Nachweise zur Mittelherkunft oder einen aktualisierten Ausweis). Die Remediation-Session ist an dieselbe `vendor_data` gebunden. Nach Abschluss wird der Status der Transaktion automatisch aktualisiert.

Das vollständige Zustandsmodell finden Sie unter [Transaktionsstatus](https://docs.didit.me/de/transaction-monitoring/statuses.md).

## Nachträglicher Import historischer Daten

Um historische Transaktionen einer bestehenden Benutzerentität nachträglich hinzuzufügen, übergeben Sie `txn_date` mit einem Datum in der Vergangenheit:

```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 '{
    "txn_id": "legacy-0001",
    "txn_date": "2024-03-15T10:00:00Z",
    "direction": "INBOUND",
    "amount": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> Historische Transaktionen werden weiterhin durch die Regel-Engine verarbeitet. Wenn Sie den Verlauf **ohne** Regeln auszulösen importieren möchten, verwenden Sie den Import-Ablauf in der Konsole, der einen Modus „Dry Ingest“ unterstützt.

## Nächste Schritte

> [card] [Transaktionen übermitteln](https://docs.didit.me/de/transaction-monitoring/transactions.md)
>
> Vollständige Referenz zum Payload.

> [card] [Regeln](https://docs.didit.me/de/transaction-monitoring/rules.md)
>
> So bewerten Regeln Transaktionen und wirken auf Benutzer.

> [card] [Status](https://docs.didit.me/de/transaction-monitoring/statuses.md)
>
> Referenz zu Transaktions- und Remediation-Status.


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