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

# Unternehmenstransaktionen: KYT-Verlauf

> Transaktionsverlauf eines Didit-Unternehmens abrufen. Zeigt, wie laufende Aktivität Velocity-, Verhaltens- und Screening-Regeln speist.

Jede Transaktion, die Sie mit einer `vendor_data`-Kennung übermitteln, die einer Business-Entität entspricht, also als Antragsteller, Überweisender, Begünstigter oder Gegenpartei, wird mit diesem Unternehmensprofil verknüpft. Das Unternehmen wird dadurch zu einem fortlaufenden Transaktionsbuch seiner Aktivitäten, und die Transaktionsüberwachung nutzt diese Historie, um Velocity-, Verhaltens- und Screening-Regeln auf Unternehmensebene zu speisen.

## Transaktionen eines Unternehmens abrufen

Filtern Sie die Transaktionsliste nach der `vendor_data` des Unternehmens:

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

Gibt jede Transaktion zurück, in der das Unternehmen als Antragsteller erscheint. Für die Historie aus Sicht der Gegenpartei filtern Sie in der Business Console (der öffentliche Listen-Endpoint filtert nur nach Antragsteller).

## Wie Transaktionen mit Unternehmen verknüpft werden

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0042"]
    A["applicant:<br/>vendor_data=biz-acme"]
    C["counterparty:<br/>vendor_data=biz-widgets"]
    B1[Business: biz-acme]
    B2[Business: biz-widgets]
    T --> A
    T --> C
    A -.-> B1
    C -.-> B2
```

Jede Transaktion enthält bis zu vier Parteien (`applicant`, `remitter`, `beneficiary`, `counterparty`). Enthält eine Partei `vendor_data`, die einer Business-Entität in Ihrer Anwendung entspricht, bindet Didit diese Partei an das Unternehmen. Parteien ohne `vendor_data` werden als externe Snapshots gespeichert, ohne Entitätsverknüpfung.

Siehe [Transaktionen einreichen](https://docs.didit.me/de/transaction-monitoring/transactions.md) für das vollständige Parteimodell.

## Gemischte Parteitypen

Eine einzelne Transaktion kann Benutzer und Unternehmen über die Parteien hinweg kombinieren, zum Beispiel wenn ein Benutzer als Privatperson an ein Unternehmen zahlt:

```json theme={null}
{
  "txn_id": "tx-0099",
  "direction": "OUTBOUND",
  "amount": "500.00",
  "currency": "EUR",
  "applicant": { "vendor_data": "user-42" },
  "counterparty": { "vendor_data": "biz-acme" }
}
```

Oder eine B2B-Überweisung zwischen zwei Unternehmen:

```json theme={null}
{
  "txn_id": "tx-0100",
  "direction": "OUTBOUND",
  "amount": "120000.00",
  "currency": "USD",
  "applicant": { "vendor_data": "biz-acme" },
  "counterparty": { "vendor_data": "biz-widgets" }
}
```

Didit löst jede Partei unabhängig anhand der `vendor_data` auf. Dieselbe Transaktion fließt in die Profile aller zugeordneten Entitäten ein.

## Aggregierte Risikosignale

Transaktionen speisen diese unternehmensbezogenen Signale:

| Signal | Verwendet von |
| - | - |
| Gesamtvolumen eingehend / ausgehend | Velocity-Regeln, Schwellenwertbildung |
| Anzahl der Transaktionen in einem Zeitfenster | Velocity-Regeln |
| Eindeutige Gegenparteien | Verhaltensregeln |
| Betroffene Hochrisikojurisdiktionen | Geografieregeln |
| 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. Trifft eine Regel zu, kann das Unternehmen je nach Aktion der Regel automatisch auf `FLAGGED` oder `BLOCKED` gesetzt werden.

## Wie Regeln auf Unternehmen wirken

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

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

Fügt eine Regel das Unternehmen einer Sperrliste hinzu, wechselt die Business-Entität in den Status `BLOCKED`, und ein `business.status.updated`-Webhook wird ausgelöst.

## Verhalten eines Unternehmens überwachen

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

* jede Transaktion in chronologischer Reihenfolge einzusehen.
* nach Status, Betrag, Richtung und Gegenpartei zu filtern.
* eine beliebige Transaktion zu öffnen, um Regelläufe, IP-Anreicherung und Ergebnisse des Krypto-Screenings zu prüfen.
* einen Fall gegen das Unternehmen zu eröffnen, um eine Untersuchung nachzuverfolgen.

## Einem Unternehmen zugeordnete Zahlungsmethoden

Jede Transaktion kann eine oder mehrere Zahlungsmethoden anhängen (Bankkarten, Bankkonten, E-Wallets, Krypto-Wallets). Gehört eine Zahlungsmethode einem Unternehmen, wird sie über die `vendor_data` zurückverknüpft. So sehen Sie direkt auf der Detailseite des Unternehmens jede Zahlungsmethode, die es bisher verwendet hat.

## Nachträgliche Erfassung historischer Transaktionen

Um historische Transaktionen für ein bestehendes Unternehmen nachzutragen, ü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": "25000.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "biz-acme" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> Historische Transaktionen durchlaufen weiterhin die Regel-Engine. Wenn Sie Historie importieren, ohne Regeln auszulösen, verwenden Sie den Import-Ablauf in der Console, der einen Dry-Ingest-Modus unterstützt.

## Nächste Schritte

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

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

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


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