> ## 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. # Transaktionsrisiko-Scoring: Formel & Schwellenwerte > Didit bewertet jede Transaktion: Regelbeiträge, Schwellenwerte, Status (APPROVED, IN_REVIEW, DECLINED). 1,000 pro Monat inklusive, dann je $0.001. Jede Transaktion erhält einen **Score**, eine Ganzzahl, die ihr Risiko zusammenfasst. Der Score bestimmt den Status der Transaktion (`APPROVED`, `IN_REVIEW`, `DECLINED`) und ob ein Alert erstellt, ein Fall eröffnet oder eine Korrektur durch den Benutzer verlangt wird. ## Die Formel ``` score = Σ(score_delta of every matched rule) ``` * Basiswert: 0. * Jede zutreffende Regel trägt ihren konfigurierten `score_delta` bei (typischerweise 25–35). * Eine Transaktion ohne zutreffende Regeln erhält einen Score von 0. ## Schwellenwerte und Status Die Score-Schwellenwerte werden pro Anwendung unter *Transactions → Settings* konfiguriert. | Einstellung | Standard | Bedeutung | | - | - | - | | `preferred_review_score_threshold` | 75 | Scores ab diesem Wert gehen in `IN_REVIEW` | | `preferred_decline_score_threshold` | 500 | Scores ab diesem Wert gehen in `DECLINED`. Der Standard- und Maximalwert (`500`) bedeutet „nie nach Score ablehnen“. Senken Sie ihn, um nach Score abzulehnen. | Statuszuweisung: ``` if decline_threshold < 500 and score >= decline_threshold: status = DECLINED else if score >= review_threshold: status = IN_REVIEW else: status = APPROVED ``` Einzelne Regelaktionen können dies überschreiben, z. B. lehnt eine Regel mit `action: change_status → DECLINED` die Transaktion unabhängig vom Score ab. ## Regelbeiträge: Beispiel Angenommen, für eine einzelne Transaktion greifen diese Regeln: | Regel | `score_delta` | | - | - | | Hochwertige ausgehende Transaktion (>\$10,000) | 30 | | Gegenpartei in einer Hochrisikojurisdiktion | 35 | | Strukturierungsmuster erkannt | 35 | Gesamt-Score = 30 + 35 + 35 = **100**. Bei einer Prüfschwelle von 60 und einer Ablehnungs-Schwelle von 85 wird diese Transaktion `DECLINED`. Mit den Standardwerten (75 für die Prüfung, 500 für die Ablehnung) wird sie `IN_REVIEW`, weil der Standardwert nie nach Score ablehnt. ## Überschreibungen durch Aktionen Regeln können den Status auch direkt setzen und dabei Score-Schwellenwerte umgehen: | Regelaktion | Wirkung | | - | - | | `change_status → DECLINED` | Transaktion unabhängig vom Score abgelehnt | | `change_status → IN_REVIEW` | Transaktion geht unabhängig vom Score in die Prüfung | | `change_status → AWAITING_USER` | Transaktion wartet auf die Korrektur durch den Benutzer. Es gilt der Workflow der Regelaktion; Bibliotheksregeln greifen auf Ihre Einstellungsauswahl zurück, dann auf Ihren Workflow für biometrische Authentifizierung (gespeichertes Gesicht erforderlich), dann auf Ihren Standard-Workflow. | | `add_score(n)` | Trägt nur zum Score bei; kein erzwungener Status | | `add_tags([...])` | Fügt Tags für die Filterung in der Konsole hinzu; keine Auswirkung auf den Score | | `add_to_list(...)` | Fügt einen Identifier einer Sperrliste hinzu | Eine einzelne Regel kann mehrere Aktionen haben, z. B. `add_score(35)` + `add_tags(["structuring"])` + `add_note("Auto-tagged by structuring preset")`. ## Warum Scores harten Regeln überlegen sind Ein reiner Schwellenwert (z. B. „jede Transaktion über \$100k ablehnen“) erfasst sowohl legitime hochwertige Transaktionen als auch tatsächliche Risiken. Wenn Sie mehrere moderate `score_delta`-Regeln mit einer Prüf- und einer Ablehnungsschwelle kombinieren, erhalten Sie: * **Mehrstufige Bewertung**: Keine einzelne Regel führt zu einer Ablehnung; mehrere Signale müssen übereinstimmen. * **Anpassbare Empfindlichkeit**: Sie können Schwellenwerte anheben oder senken, ohne die Regeldefinitionen zu ändern. * **Abstufung des Schweregrads**: Eine Transaktion mit Score 65 geht in die Prüfung (lohnt einen Blick), Score 90 führt zur Ablehnung (schwerwiegend). ## Schwellenwerte konfigurieren Unter *Transactions → Settings*: * **Prüfschwelle**: Erhöhen Sie sie, wenn Ihre Prüfwarteschlange überlaufen ist. Senken Sie sie, um mehr Grenzfälle zu erfassen. * **Ablehnungs-Schwelle**: Erhöhen Sie sie, um Ablehnungen bei falsch positiven Ergebnissen zu reduzieren. Senken Sie sie, um aggressiver zu blockieren. Setzen Sie sie auf den Maximalwert (`500`), um hohe Scores in die Prüfung statt in eine automatische Ablehnung zu leiten. Änderungen gelten nur für **neue** Transaktionen. Historische Transaktionen behalten ihren zum Zeitpunkt der Bewertung ermittelten Status. ## Testmodus für Regeln Regeln können im `TEST`-Modus laufen: * Die Regel bewertet Transaktionen, trägt aber weder zum Score noch zum Status bei. * Es werden `TransactionRuleRun`-Datensätze mit `is_test = true` erstellt. * Sie können so die Trennschärfe einer Regel prüfen, ohne Ablehnungen im Produktivbetrieb zu riskieren. Wechseln Sie in den Modus `ACTIVE`, sobald Sie mit der Trennschärfe zufrieden sind. ## Schweregrad und veraltete Felder Das Feld `severity` bei Transaction und TransactionAlert ist nullfähig und veraltet. Neue Regelauswertungen setzen es nicht. Verwenden Sie `score` als primäres Risikosignal. ## Scores prüfen ### Über die API Jede Antwort zu einer Transaktion enthält `score` und ein Array `rule_runs[]` mit einem Eintrag pro zutreffender Regel (alle Felder finden Sie im [Antwortschema](https://docs.didit.me/de/transaction-monitoring/response-schema.md#regelausführungen)): ```json theme={null} { "txn_id": "tx-0002", "status": "IN_REVIEW", "score": 65, "rule_runs": [ { "rule_title": "High-value outbound", "matched": true, "score_delta": 30, "severity": null, "status_target": null, "action_summary": "score +30" }, { "rule_title": "High-risk jurisdiction counterparty", "matched": true, "score_delta": 35, "severity": "HIGH", "status_target": "IN_REVIEW", "action_summary": "score +35; add_tag:high_risk_country" } ] } ``` ### In der Konsole Auf der Detailseite der Transaktion zeigt der Tab **Score** die Aufschlüsselung des Beitrags jeder zutreffenden Regel sowie die resultierende Statuszuordnung. Fahren Sie mit der Maus über das Score-Badge, um die bei der Bewertung verwendeten Schwellenwerte anzuzeigen. ## Nächste Schritte > [card] [Regeln](https://docs.didit.me/de/transaction-monitoring/rules.md) > > Aufbau und Auswertung von Regeln. > [card] [Alerts](https://docs.didit.me/de/transaction-monitoring/alerts.md) > > Was passiert, wenn eine Regel greift. > [card] [Einstellungen](https://docs.didit.me/de/transaction-monitoring/settings.md) > > Schwellenwerte konfigurieren. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.