Zum Hauptinhalt springen
PUT
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.

Body

application/json

Alle Felder optional; PUT wendet eine partielle Aktualisierung an.

is_enabled
boolean
Maximum string length: 255
lei
string
Maximum string length: 20
jurisdiction
string
Maximum string length: 8
name_matching_strictness
enum<string>

CONTAINS akzeptiert einen Namen, dessen Wörter alle im anderen vorkommen.

Verfügbare Optionen:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer
Erforderlicher Bereich: x >= 1
timeout_outcome
enum<string>
Verfügbare Optionen:
HOLD,
REJECT,
PROCEED
compliance_email
string<email>

Compliance-Kontakt-E-Mail für Ihr VASP-Profil. Das Didit-Netzwerk listet Ihr Profil erst auf, sobald diese Adresse über einen per E-Mail gesendeten Link bestätigt wurde (POST /v3/travel-rule/settings/compliance-email/confirmation/); eine Änderung erfordert eine erneute Bestätigung.

is_discoverable
boolean

Gibt an, ob Ihr VASP-Profil im Didit-Netzwerk gelistet werden kann: für andere Didit-Kunden unter GET /v3/travel-rule/vasps/ auffindbar und über die Schiene INTERNAL erreichbar. Die Listung erfordert außerdem eine aktive Anwendung, aktivierte Travel Rule, einen offiziellen Firmennamen und eine bestätigte Compliance-E-Mail; didit_network gibt an, welche Voraussetzungen fehlen. Standardmäßig true.

threshold_amount
string

Dezimal-Zeichenkette, null oder größer, in der Standardwährung Ihrer Anwendung. Mindesttransferbetrag, der einen verwalteten Austausch auslöst.

ownership_validation_mode
enum<string>

Siehe das Antwortfeld mit demselben Namen.

Verfügbare Optionen:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

Dezimal-Zeichenkette, 0 oder höher.

data_sharing_fields
object

Zusammengeführt pro Entitätstyp: Ein Entitätstyp, den Sie weglassen, behält seine aktuelle Auswahl. Eine Auswahl, die die Auftraggeber-Pflichten Ihres jurisdiction-Regimes (EU TFR oder FATF-Empfehlung 16) nicht erfüllen kann, einschließlich einer leeren Liste, wird mit 400 abgewiesen.

matching_rules
object

Zusammengeführt pro Entitätstyp und pro Feld darin. Ein Feld, das für diesen Entitätstyp nicht verglichen wird (beispielsweise date_of_birth für company), wird mit 400 abgewiesen.

inbound_auto_accept
boolean
allow_self_declaration
boolean
allow_screenshot_proof
boolean

Wenn true, bietet das Wallet-Ownership-Widget den Upload von Screenshots als Methode für den Eigentumsnachweis an. Standardmäßig true.

auto_wallet_verification
boolean
vasp_attribution_enabled
boolean
counterparty_screening_enabled
boolean

Opt-in-Screening auf Sanktionen und negative Medienberichte von VASPs der Gegenpartei, abgerechnet pro Screening zum Preis für Unternehmens-AML-Screening. Wenn aktiviert, prüft Didit die Gegenpartei, die ein ausgehender Transfer erreicht (wobei ein Screening wiederverwendet wird, das jünger als 30 Tage ist), und Sie können einen über POST /v3/travel-rule/vasps/{vasp_id}/screening/ screenen. Standardmäßig false: Es wird nichts geprüft oder abgerechnet.

sunrise_policy
enum<string>

HOLD, REJECT, PROCEED oder leer, um timeout_outcome zu folgen. Siehe das gleichnamige Antwortfeld.

Verfügbare Optionen:
,
HOLD,
REJECT,
PROCEED
non_responsive_policy
enum<string>

HOLD, REJECT, PROCEED oder leer, um timeout_outcome zu folgen. Siehe das gleichnamige Antwortfeld.

Verfügbare Optionen:
,
HOLD,
REJECT,
PROCEED
disabled_networks
enum<string>[]

Netzwerke, die von der Plattform-Mitgliedschaft abgemeldet wurden. Dies deaktiviert weder Ihre verknüpften eigenen Mitgliedschaften noch stellt es nicht verfügbare Netzwerke bereit.

Verfügbare Optionen:
GTR,
TRUST,
VERIFYVASP,
SYGNA

Antwort

Aktualisierte Einstellungen und Profil im gleichen Format wie GET.

is_enabled
boolean

Gibt an, ob der verwaltete Travel-Rule-Verhandlungsablauf für ausgehende travelRule-Transaktionen bei dieser Anwendung aktiv ist.

jurisdiction
string

Der Jurisdiktionscode der Betriebsjurisdiktion Ihres VASP. Standardmäßig "EU". Didit ordnet ihn dem Regime zu, das auf Ihren Travel-Rule-Transaktionen als travel_rule_regime vermerkt wird (beispielsweise wird EU oder der Code eines EU-Mitgliedstaats zu eu), worauf Transaktionsregeln aufbauen können. Andere Didit-Kunden sehen diesen als Ihre Jurisdiktion im VASP-Verzeichnis, sobald das Didit-Netzwerk Ihr Profil auflistet.

Maximum string length: 8
name_matching_strictness
enum<string>

Wie genau die Namen der Begünstigten übereinstimmen müssen, bevor ein Transfer COMPLETED erreichen kann. CONTAINS akzeptiert einen Namen, dessen Wörter alle im anderen vorkommen.

Verfügbare Optionen:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer

Stunden, die ein Transfer mit dem Status AWAITING_COUNTERPARTY unbestätigt bleiben darf, bevor der periodische Sweeper ihn ablaufen lässt. Standard: 48.

Erforderlicher Bereich: x >= 1
timeout_outcome
enum<string>

Was mit der zugrunde liegenden Transaktion passiert, wenn ein Transfer abläuft. Standard HOLD. sunrise_policy und non_responsive_policy haben Vorrang, wenn sie zutreffen und festgelegt sind.

Verfügbare Optionen:
HOLD,
REJECT,
PROCEED
threshold_amount
string

Dezimal-Zeichenkette in der Standardwährung Ihrer Anwendung. Mindesttransferbetrag, der einen verwalteten Austausch auslöst; Transfers darunter werden direkt als NOT_APPLICABLE aufgelöst. Didit vergleicht den in Ihre Standardwährung umgerechneten Transaktionsbetrag oder den von Ihnen gesendeten amount_in_default_currency; wenn kein umgerechneter Betrag verfügbar ist, gilt der Schwellenwert nicht. Standardwert ist "0.00" (die EU-TFR sieht keinen Mindestbetrag vor).

ownership_validation_mode
enum<string>

Wie viel Nachweis für die Eigentümerschaft einer Wallet erforderlich ist. FULL erfordert immer einen Nachweis (signierte Nachricht, Testeinzahlung oder geprüfter Screenshot), niemals das Wort des Endbenutzers. SIMPLIFIED akzeptiert eine Eigenerklärung unterhalb von simplified_validation_threshold und einen Nachweis darüber. AUTOMATED lässt das Adressbuch und frühere Nachweise eigenständig antworten, einschließlich Eigenerklärungen, solange allow_self_declaration wahr ist. Standardwert AUTOMATED.

Verfügbare Optionen:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

Dezimal-Zeichenkette, Standardwert "0.00". Im Modus SIMPLIFIED akzeptiert ein Transfer unterhalb dieses Betrags (in der Schwellenwertwährung) eine Eigenerklärung. Ein Transfer ohne Betrag in dieser Währung gilt als darüberliegend.

data_sharing_fields
object

Die Felder, die Didit pro Entitätstyp an das Gegenpartei-VASP über Ihre eigenen Benutzer sendet. Der name und die wallet_address werden immer gesendet, unabhängig vom Inhalt der Liste. Ein Entitätstyp, den Sie nie ausgewählt haben, teilt jedes Feld. Eine leere Liste ist ebenfalls eine Auswahl: Sie teilt nur den Namen und die Wallet.

matching_rules
object

Wie genau jedes Feld der Daten der Gegenpartei mit den bei Ihnen vorliegenden Daten verglichen wird, pro Entitätstyp. Ein weggelassenes Feld behält seinen Standardwert. NONE überspringt den Vergleich, STRICT erfordert exakt dieselben Wörter, CONTAINS akzeptiert einen Wert, dessen Wörter alle im anderen vorkommen, DEFAULT ist der Standard-Teilmengenabgleich und FUZZY akzeptiert ähnliche Schreibweisen (sowie bei Geburtsdaten einen vertauschten Tag und Monat).

Der rechtliche Name Ihres VASP. Erforderlich (nicht leer), um is_enabled auf true zu setzen.

lei
string

Ihr Legal Entity Identifier, angezeigt im VASP-Verzeichnis.

compliance_email
string<email>

Compliance-Kontakt-E-Mail für Ihr VASP-Profil. Das Didit-Netzwerk listet Ihr Profil erst auf, sobald diese Adresse über einen per E-Mail gesendeten Link bestätigt wurde (POST /v3/travel-rule/settings/compliance-email/confirmation/); eine Änderung erfordert eine erneute Bestätigung.

is_discoverable
boolean

Gibt an, ob Ihr VASP-Profil im Didit-Netzwerk gelistet werden kann: für andere Didit-Kunden unter GET /v3/travel-rule/vasps/ auffindbar und über die Schiene INTERNAL erreichbar. Die Listung erfordert außerdem eine aktive Anwendung, aktivierte Travel Rule, einen offiziellen Firmennamen und eine bestätigte Compliance-E-Mail; didit_network gibt an, welche Voraussetzungen fehlen. Standardmäßig true.

inbound_auto_accept
boolean

Wenn true, wird eine eingehende TRP-Anfrage, deren Begünstigten-Wallet ein verifizierter Adressbucheintrag mit übereinstimmendem Namen ist, automatisch genehmigt. Wenn false, verbleibt diese Anfrage im Status ON_HOLD, bis Sie sie über den Eigentums-Endpoint genehmigen oder ablehnen. Transfers über die INTERNAL-Rail sowie After-Deposit-Transfers sind davon nicht betroffen. Standardmäßig true.

allow_self_declaration
boolean

Wenn true, bietet das Wallet-Ownership-Widget eine Selbsterklärung als Fallback-Nachweismethode an. Standardmäßig true.

allow_screenshot_proof
boolean

Wenn true, bietet das Wallet-Ownership-Widget den Upload von Screenshots als Methode für den Eigentumsnachweis an. Standardmäßig true.

auto_wallet_verification
boolean

Wenn true, wird beim Übermitteln eines ausgehenden Travel-Rule-Transfers, der einen Endbenutzer-Nachweis der Wallet-Kontrolle erfordert, automatisch eine an die Transaktion gebundene Wallet-Ownership-Widget-Sitzung generiert und im action_required-Block der Transaktion bereitgestellt. Standardmäßig true.

vasp_attribution_enabled
boolean

Wenn true, wird ein ausgehender Travel-Rule-Transfer, den keine Rail routen kann, mittels Blockchain-Analysen zugeordnet: Die Ziel-Wallet wird dem Eigentümer-VASP zugeordnet, die Entität wird auf dem Transfer sowie im VASP-Verzeichnis erfasst und die Rails werden einmalig mit dem zugeordneten Namen erneut ausgeführt. Standardmäßig true.

counterparty_screening_enabled
boolean

Opt-in-Screening auf Sanktionen und negative Medienberichte von VASPs der Gegenpartei, abgerechnet pro Screening zum Preis für Unternehmens-AML-Screening. Wenn aktiviert, prüft Didit die Gegenpartei, die ein ausgehender Transfer erreicht (wobei ein Screening wiederverwendet wird, das jünger als 30 Tage ist), und Sie können einen über POST /v3/travel-rule/vasps/{vasp_id}/screening/ screenen. Standardmäßig false: Es wird nichts geprüft oder abgerechnet.

sunrise_policy
enum<string>

Auswirkung eines abgelaufenen Transfers auf dessen Transaktion, wenn die Gegenpartei ein Verzeichniseintrag in einer Rechtsordnung unter sunrise_jurisdictions ist, die die Travel Rule noch nicht durchsetzt: HOLD verschiebt sie zur Prüfung, REJECT lehnt sie ab, PROCEED belässt ihren Status unverändert. Leer (Standardwert) folgt timeout_outcome. Gilt vor non_responsive_policy.

Verfügbare Optionen:
,
HOLD,
REJECT,
PROCEED
sunrise_jurisdictions
string[]
read-only

Schreibgeschützt. Die Länder (ISO 3166 Alpha-2), die Didit als in einer Travel Rule-Sunrise-Periode befindlich behandelt, in der die sunrise_policy gilt. Derzeit CO, KH und VN. Jede andere Rechtsordnung sowie eine leere oder unbekannte Angabe folgt dem timeout_outcome.

non_responsive_policy
enum<string>

Auswirkung eines abgelaufenen Transfers auf dessen Transaktion, wenn die Gegenpartei ein Verzeichniseintrag ist, dessen Reaktionsfähigkeit UNRESPONSIVE ist: HOLD, REJECT oder PROCEED, wie bei timeout_outcome. Leer (Standardwert) folgt timeout_outcome. sunrise_policy gilt zuerst, wenn beides zutrifft.

Verfügbare Optionen:
,
HOLD,
REJECT,
PROCEED
travel_address
string

Schreibgeschützt. Die eigene Travel Address Ihres VASP – der kodierte eingehende TRP-Anfrage-Endpoint, über den andere VASPs Sie erreichen. Leer, solange is_enabled den Wert false hat.

disabled_networks
enum<string>[]

Netzwerke, die von der Plattform-Mitgliedschaft abgemeldet wurden. Dies deaktiviert weder Ihre verknüpften eigenen Mitgliedschaften noch stellt es nicht verfügbare Netzwerke bereit.

Verfügbare Optionen:
GTR,
TRUST,
VERIFYVASP,
SYGNA
networks
object
read-only

Pro Netzwerk, wie diese Anwendung senden würde und warum sie es nicht kann. Kein Netzwerk, einschließlich GTR, ist standardmäßig enthalten: Ein Netzwerk ist über Ihre eigene verknüpfte Mitgliedschaft erreichbar oder über die Mitgliedschaft von Didit, sobald die Mitgliedschaft von Didit in diesem Netzwerk aktiv ist und Ihr eigener Teilnehmer darauf aktiv ist. Keine Live-Prüfung von Status oder Zustellung.

didit_network
object
read-only

Gibt an, ob das Didit-Netzwerk Ihr VASP-Profil listet, sodass andere Didit-Kunden es im Verzeichnis finden und über die INTERNAL-Schiene erreichen können, sowie jede Bedingung, die noch fehlt.

Zuletzt geändert am 7. November 2026