Zum Hauptinhalt springen
GET
curl

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

transaction_id
string<uuid>
erforderlich

Stabile Transaktions-UUID von Didit (die von create / list zurückgegebene uuid, nicht Ihre txn_id).

Antwort

Vollständige Transaktionsdetails.

Vollständiger Überwachungsdatensatz für eine Transaktion, wie von GET /v3/transactions/{transaction_id}/ und POST /v3/transactions/ zurückgegeben.

uuid
string<uuid>

Stabiler Transaktionsbezeichner von Didit. Als {transaction_id} für Folgeaufrufe verwenden.

environment
enum<string>

Umgebung der Anwendung, zu der die Transaktion gehört. Eine sandbox-Transaktion wird gespeichert, aber niemals ausgewertet, gescreent, benachrichtigt oder abgerechnet, sodass ihre leeren rule_runs „nicht ausgewertet“ bedeuten.

Verfügbare Optionen:
live,
sandbox
transaction_number
integer

Fortlaufende Transaktionsnummer innerhalb der Anwendung, wie in der Console angezeigt (z. B. 4123).

txn_id
string

Die transaction_id, die Sie bei der Erstellung angegeben haben (max. 128 Zeichen). Eindeutig pro Anwendung.

txn_date
string<date-time>

Wann die Transaktion stattgefunden hat (aus transaction_at; standardmäßig der Übermittlungszeitpunkt).

zone_id
string | null

Beim Erstellen angegebene IANA-Zeitzonenkennung.

transaction_type
string

Kategorie auf oberster Ebene wie gespeichert: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent. Beachten Sie, dass mehrteilige Werte in camelCase zurückgegeben werden, selbst wenn sie in snake_case übermittelt wurden.

action_type
string

Untertyp innerhalb der Kategorie (z. B. deposit, withdrawal, transfer). Standardmäßig die Kategorie, falls nicht angegeben.

direction
enum<string>

Richtung relativ zur betreffenden Entität. Wird unabhängig von der übermittelten Schreibweise in Großbuchstaben gespeichert (bei der Eingabe werden in/out/inbound/outbound akzeptiert).

Verfügbare Optionen:
INBOUND,
OUTBOUND
status
enum<string>

Aktuelles Überwachungsergebnis. Transaktionen werden als APPROVED erstellt; Regeln können sie synchron auf IN_REVIEW/DECLINED umstellen.

Verfügbare Optionen:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
source
enum<string>

Wie der Datensatz entstanden ist: LIVE für Transaktionen, die über die API oder das SDK übermittelt wurden, IMPORTED für Transaktionen, die über den Import in der Konsole geladen wurden.

Verfügbare Optionen:
LIVE,
IMPORTED
amount
string

Transaktionsbetrag als Dezimalstring ohne nachgestellte Nullen (z. B. "1500", "0.5", "0.123456789012345678"). Bis zu 18 Dezimalstellen.

currency
string

Währungscode von amount. Jeder alphabetische ISO-4217-Code wird akzeptiert (z. B. EUR, USD, NGN), ebenso wie ein Krypto-Asset-Symbol (z. B. BTC). Bevorzugen Sie einen aktuell im Umlauf befindlichen Code. Nicht jeder akzeptierte Code verfügt über einen Wechselkurs: Wenn für den Code keiner verfügbar ist (beispielsweise die ISO-Verrechnungseinheit XSU oder ein Krypto-Symbol, für das Didit keine Kurse bereitstellt), schlägt die automatische Konvertierung fehl und preferred_currency_amount wird als null zurückgegeben, es sei denn, die Anfrage enthielt einen vorkonvertierten Wert für amount_in_default_currency.

currency_type
string | null

fiat oder crypto, wie in currency_kind übermittelt.

amount_in_default_currency
string | null

Von Ihnen übermittelter, vorab umgerechneter Betrag als Dezimal-String ohne nachgestellte Nullen.

default_currency_code
string | null
preferred_currency_amount
string | null

amount umgerechnet in die bevorzugte Währung der Anwendung, sofern verfügbar.

preferred_currency_code
string | null
payment_details
string | null

Freitext-Zahlungsreferenz oder -Verwendungszweck aus der Übermittlung.

payment_txn_id
string | null

Externe Zahlungssystem-Referenz (z. B. Blockchain-Transaktions-Hash) aus payment_reference_id.

score
integer

Durch Regeln kumulierter Risiko-Score (typischerweise 0–100). Höher = riskanter.

severity
enum<string> | null

Kategorische Risikoschwere, festgelegt durch Regeln/Anbieter (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). null, bis ein Wert festgelegt wird.

Verfügbare Optionen:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

Maschinenlesbarer Grund für den aktuellen status.

decision_reason_label
string | null

Lesbare Bezeichnung für decision_reason_code.

vendor_data
string | null

Bequemlichkeitskopie der vendor_data des Antragstellers.

metadata
object

Snapshot der Payloads von subject und counterparty, wie sie zum Zeitpunkt der Erstellung übermittelt wurden.

props
object

Die custom_properties, die Sie bei der Erstellung angegeben haben. Jeder Schlüssel kann in Regelbedingungen als custom_values.<key> adressiert werden.

tags
object[]

An die Transaktion angehängte Tags (manuell oder durch Regeln).

parties
object[]

Transaktionsparteien (Antragsteller, Gegenpartei).

payment_methods
object[]

Mit der Transaktion verknüpfte Zahlungsmethoden.

documents
object[]

Dateien, die der Transaktion über die Konsole angehängt wurden. [], wenn keine vorhanden sind.

activities
object[]

Einträge im Aktivitätsprotokoll (Erstellung, Notizen, manuelle Prüfungen, Statusänderungen).

alerts
object[]

Aktuell immer leer. Ein offener Alert ist eine Transaktion mit dem Status IN_REVIEW oder AWAITING_USER.

rule_runs
object[]

Ausführungsergebnisse pro Regel – welche Regel ausgelöst wurde und mit welcher Auswirkung auf den Score.

provider_results
object[]

Unverarbeitete Provider-Payloads (AML-Screening, Blockchain-Analysen usw.).

travel_rule
object | null

Travel Rule-Transfer oder -Prüfung. Wird ausgefüllt, wenn travel_rule_details übermittelt wurde, sowie wenn Travel Rule aktiviert ist und die Transaktion mit transaction_category: travelRule erstellt wurde (Didit initiiert den Austausch selbst, auch ohne travel_rule_details). null, wenn kein Transfer oder keine Prüfung existiert. Bei einem eingehenden Transfer bleiben originator_data und beneficiary_data der Gegenpartei maskiert (data_masked: true), bis die Wallet-Inhaberschaft bestätigt ist.

network_snapshot
object | null

Graph-Snapshot verknüpfter Transaktionen/Parteien, der von der Regel-Engine verwendet wird. Entweder der mit der Transaktion übermittelte network_snapshot oder der Graph, den Didit aus einem erfolgreichen AML-Wallet-Screening erstellt (der einen übermittelten ersetzt). null, wenn keines von beiden existiert.

remediation
object | null

Korrektursitzung, die dem Benutzer angeboten wird, wenn eine erneute Verifizierung erforderlich ist. Abgelöst durch action_required, den kanonischen Block; aus Gründen der Abwärtskompatibilität beibehalten.

action_required
Verification session · object

Ausstehende Endbenutzer-Aktion, die zum Abschluss dieser Transaktion erforderlich ist, oder null, wenn keine vorhanden ist. Die Didit-SDKs starten die Aktion standardmäßig automatisch und aktualisieren die Transaktion nach deren Abschluss. Zwei Varianten, unterschieden durch type: verification_session (eine gehostete Verifizierungssitzung, die durch eine Regelaktion erstellt wurde) und wallet_ownership (eine Sitzung des Wallet-Ownership-Widgets, die für einen Travel-Rule-Transfer automatisch erstellt wurde, der einen Nachweis der Wallet-Kontrolle benötigt, gesteuert durch die Travel-Rule-Einstellung auto_wallet_verification). Wenn beide zutreffen könnten, hat wallet_ownership Vorrang, da sie den Travel-Rule-Austausch blockiert.

cost_breakdown
object | null

Kosten dieser Transaktion: total_price und items, eine pro Belastung, jeweils mit usage_type, price, details und created_at. Eine erneute Überprüfung derselben Transaktion ist ein neues Element.

Zuletzt geändert am 7. November 2026