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

# Transaktionsüberwachung Schnellstart: Setup in 10 Minuten

> Didit: In unter 10 Minuten erste Transaktion senden, Regeln auslösen und Webhooks einrichten. 1,000 Transaktionen/Monat inklusive, danach $0.001 je.

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

**1. Eine Basistransaktion einreichen**

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

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.

**2. 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.

**3. Transaktionen einreichen, die die Regel auslösen**

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

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.

**4. Transaktions-Webhooks abonnieren**

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

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

```bash theme={null}
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](https://docs.didit.me/de/transaction-monitoring/webhooks.md).

Jede weitere Transaktion wird in Echtzeit an Ihren Endpoint gesendet.

**5. 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.

**6. Eine Transaktion über die API abrufen**

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

Gibt das vollständige [Antwortschema](https://docs.didit.me/de/transaction-monitoring/response-schema.md) 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

> [card] [Integrationsleitfaden](https://docs.didit.me/de/transaction-monitoring/integration-guide.md)
>
> Vollständige Architektur und Muster.

> [card] [Regeln im Detail](https://docs.didit.me/de/transaction-monitoring/rules.md)
>
> Wie Regeln funktionieren: Bedingungen, Aggregationen, Aktionen.

> [card] [Risiko-Scoring](https://docs.didit.me/de/transaction-monitoring/risk-scoring.md)
>
> Wie Scores zu Status zusammengeführt werden.

> [card] [Transaktions-Payload](https://docs.didit.me/de/transaction-monitoring/transactions.md)
>
> Das vollständige Schema für die Einreichung von Transaktionen.

> [card] [Status](https://docs.didit.me/de/transaction-monitoring/statuses.md)
>
> Zustände von Transaktionen, Alerts und Fällen.

> [card] [Fälle](https://docs.didit.me/de/transaction-monitoring/cases.md)
>
> Untersuchen und abschließen.


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