Zum Hauptinhalt springen
POST
curl
Didit’s VASP-Erstellungs-API fügt eine Gegenpartei privat dem Verzeichnis Ihrer Anwendung hinzu und sendet optional eine Einladung an deren Compliance-E-Mail-Adresse. Senden Sie name und email. Sie können außerdem lei (20 alphanumerische Zeichen), jurisdiction (ein ISO-Ländercode im Alpha-2- oder Alpha-3-Format) und invite (Standardwert: false) angeben. Leere optionale Werte für LEI und jurisdiction werden akzeptiert. Die API benötigt Schreibzugriff auf Transaktionen. Die Antwort 201 ist ein Verzeichniseintrag mit source: added_by_you. Der Compliance-Kontakt ist nur für Ihre Anwendung sichtbar. Das Hinzufügen eines Eintrags bestätigt seine Identität nicht und macht ihn nicht zu einem Mitglied des Didit-Netzwerks. Bei einer Übereinstimmung des sichtbaren Namens oder der LEI gibt die API 409 mit vasp_id zurück. Wählen Sie in diesem Fall stattdessen den bestehenden Eintrag aus. Ungültige Felder führen zu 400. Verwenden Sie VASP-Verzeichnis durchsuchen, um den Eintrag und seine verfügbaren Routen zu finden. Verwenden Sie dessen id mit der Aktion beneficiary_vasp in Eine Übertragung aktualisieren. Hinweise zu Routing und Sorgfaltspflicht finden Sie im Leitfaden zum Verzeichnis.

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
name
string
erforderlich

Name des VASP, von führenden und nachfolgenden Leerzeichen bereinigt; darf nicht leer sein.

Required string length: 1 - 255
email
string<email>
erforderlich

E-Mail-Adresse für Compliance, die als anwendungsprivater Kontakt gespeichert und für eine optionale Einladung verwendet wird.

Maximum string length: 254
lei
string
Standard:""

Optionale LEI, in Großbuchstaben normalisiert.

Pattern: ^([A-Za-z0-9]{20})?$
jurisdiction
string
Standard:""

Optionaler ISO-3166-Ländercode mit Alpha-2 oder Alpha-3, in Großbuchstaben normalisiert.

Maximum string length: 3
invite
boolean
Standard:false

Sendet eine Einladung an die angegebene E-Mail-Adresse.

Antwort

Erfolgreiche Antwort.

Ein VASP des Verzeichnisses oder ein Mitglied des Didit-Netzwerks mit den Routen, über die Ihre Anwendung ihn erreicht. Ein Kunde ist nur dann Mitglied des Didit-Netzwerks, solange seine Anwendung live ist, seine Travel Rule aktiviert ist, sein Profil auffindbar ist, er einen juristischen Namen und eine bestätigte Compliance-E-Mail hat und Didit die Anwendung nicht als Test-, Demo- oder interne Anwendung markiert hat. Jede Zeile enthält außerdem die geteilte Due-Diligence-Bewertung (dd_score, risk_level, responsiveness, essential_checks) sowie die eigene Entscheidung, das Entity-Screening und die Fragebögen Ihrer Anwendung, die kein anderer Kunde sieht.

id
string<uuid>

Die ID des Eintrags, für GET /v3/travel-rule/vasps/{vasp_id}/.

kind
enum<string>

directory für einen gemeinsam genutzten oder anwendungsinternen Verzeichniseintrag; didit für ein Mitglied des Didit-Netzwerks.

Verfügbare Optionen:
directory,
didit
name
string
lei
string
jurisdiction
string

ISO 3166-Ländercode, wie von der Quelle bereitgestellt.

domains
string[]

Die Web-Domains des VASPs. Für Didit-Netzwerkmitglieder immer leer.

reachable
boolean

Gibt an, ob Ihre Anwendung über eine verfügbare Route zu diesem VASP oder zu einer seiner Einheiten für eine Marke verfügt. Bei Mitgliedern des Didit-Netzwerks immer true, außer bei einer Sandbox-Anwendung, bei der jede Zeile false ist.

aliases
object[]

Andere Namen, unter denen der VASP geführt wird.

networks
object[]
routes
object[]
umbrella
object | null

Die Marke, deren reguliertes Unternehmen dieser Eintrag ist. Null, wenn er nicht Teil einer solchen ist.

entities
object[]

Für eine Marke: die regulierten Entitäten, die ihre Überweisungen empfangen. Eine Überweisung, die die Marke benennt, geht an die erreichbare Entität in der von ihr angegebenen Jurisdiktion (beneficiary_data.counterparty_vasp_jurisdiction), andernfalls an die Entität, die laut Blockchain-Analytics-Attribution mit der Ziel-Wallet verknüpft ist, andernfalls an die einzige erreichbare Entität, wenn keine Jurisdiktion angegeben ist. Zwischen zwei gleichermaßen passenden Entitäten wird niemals geraten.

contacts
object[]

Die Kontakte der Plattform für diesen VASP und die Ihrer eigenen Anwendung.

dd_status
enum<string>

Didits Verifizierungsstatus des Eintrags, bewertet durch die Verifizierungskomponente von dd_score. Immer COMPLETED für ein Mitglied des Didit-Netzwerks.

Verfügbare Optionen:
NOT_STARTED,
IN_PROGRESS,
COMPLETED,
REJECTED
dd_score
integer | null

Der geteilte Due-Diligence-Score eines Verzeichniseintrags, 0 bis 100, wobei ein höherer Wert sicherer ist (siehe dd_score_semantic): die Summe der Punkte in dd_score_breakdown. Null für ein Didit-Netzwerkmitglied, das nicht bewertet wird. Ein Eintrag, der noch nicht bewertet wurde (dd_assessed_at null), zeigt 0 mit einem leeren risk_level; lesen Sie daher risk_level statt des Roh-Scores aus.

Erforderlicher Bereich: 0 <= x <= 100
reachable_rails
enum<string>[]

Auf dem Eintrag erfasste Zahlungswege. Lesen Sie Routen, um zu sehen, was Ihre Anwendung aktuell nutzen kann.

Verfügbare Optionen:
INTERNAL,
TRP,
GTR,
TRUST,
VERIFYVASP,
SYGNA,
EMAIL
is_didit_customer
boolean

true für ein Mitglied des Didit-Netzwerks (dd_status ist für diese immer COMPLETED, dd_score null und risk_level leer) und für einen Verzeichniseintrag, der mit einem Didit-Kunden verknüpft ist.

dd_score_breakdown
object

Ein Objekt pro Komponente von dd_score. Komponenten, ihre Gewichtung (max.) und ihre Ursachencodes: jurisdiction, 25 (jurisdiction_not_high_risk, jurisdiction_high_risk, jurisdiction_unknown); verification, 15 (dd_status_completed, dd_status_in_progress, dd_status_not_started, dd_status_rejected); protocol, 15 (native_rail, email_only, no_rail); lei, 10 (lei_valid, lei_missing); history, 10 (history, no_history); essentials, 15 (essential_checks, no_essential_checks); responsiveness, 10 (responsive, unresponsive, responsiveness_unknown). Leer für ein Mitglied des Didit-Netzwerks.

dd_assessed_at
string<date-time> | null

Wann dd_score, risk_level und responsiveness zuletzt berechnet wurden: nachdem ein Austausch mit dem Eintrag abgeschlossen, beendet oder abgelaufen ist, keine Übereinstimmung ergibt oder abgelehnt wird, wenn Didit den Eintrag aktualisiert oder kuratiert, und bei der wöchentlichen Verzeichnisaktualisierung. Null für ein Mitglied des Didit-Netzwerks.

dd_score_semantic
enum<string>

In welche Richtung dd_score verläuft: immer higher_is_safer.

Verfügbare Optionen:
higher_is_safer
risk_level
enum<string>

Das Band, in das dd_score fällt: LOW (70 oder mehr), MEDIUM (40 bis 69) oder HIGH (unter 40). Leer bei einem Didit-Netzwerkmitglied und bei einem Eintrag, der noch nicht bewertet wurde. Filtern Sie danach mit risk. Ihr eigenes als auffällig markiertes Screening ändert diesen gemeinsamen Wert niemals: Es setzt stattdessen counterparty_risk_level in Ihren Regeln auf HIGH.

Verfügbare Optionen:
LOW,
MEDIUM,
HIGH,
responsiveness
object

Gibt an, ob der VASP Travel-Rule-Anfragen beantwortet: der Anteil der von Didit-Kunden in den letzten 90 Tagen an ihn gestellten Anfragen, die er beantwortet hat. Es zählen nur Anfragen, die über eine Netzwerk- oder Protokollschiene oder per E-Mail an eine geteilte Adresse (die Compliance-Adresse des Eintrags oder einen Plattformkontakt) gesendet wurden; eine Anfrage an eine von einem Kunden eingegebene Adresse oder an den privaten Kontakt eines Kunden zählt niemals. Eine abgelaufene Anfrage gilt als unbeantwortet; ein abgeschlossener Austausch, eine Ablehnung oder ein Datenkonflikt gilt als Antwort; eine stornierte Anfrage oder eine nicht erreichbare Schiene ist keines von beidem. Für ein Didit-Netzwerkmitglied immer UNKNOWN mit Zählerständen von null.

essential_checks
object

Der Bericht über die grundlegenden Prüfungen eines Verzeichniseintrags, der ausschließlich aus den verifizierten Quellen der Plattform erstellt wird: Registrierung (ein offizielles Register führt den VASP: das vorläufige MiCA-Register der EU, das öffentliche TRISA-Verzeichnis oder das weltweite LEI-Register), Lizenz (eine MiCA-Genehmigung liegt vor und ist aktuell), Domain (die Domain des Eintrags stimmt mit seinem TRP-Endpoint oder der Website aus seinem Register überein) und LEI (sein LEI-Eintrag ist aktiv, ausgestellt und stimmt mit den Namen und dem Land des Eintrags überein). Die Essentials-Komponente von dd_score ist der Anteil der entschiedenen Prüfungen, die bestanden werden. Leer, bis die wöchentliche Verzeichnisaktualisierung den Eintrag erstmals prüft, und für ein Didit-Netzwerkmitglied immer leer.

decision
object | null

Die Entscheidung Ihrer Anwendung über diesen VASP oder bei einer Entität ohne eigene Entscheidung die ihrer Marke (inherited_from benennt die Marke). Null, wenn keine vorhanden ist. Nur für Ihre Anwendung sichtbar.

entity_screening
object | null

Das neueste Screening auf Sanktionen und negative Medienberichte dieses VASP durch Ihre Anwendung. Null, wenn Sie es nie überprüft haben. Nur für Ihre Anwendung sichtbar.

questionnaires
object[]

Die Due-Diligence-Fragebögen Ihrer Anwendung mit diesem VASP, neueste zuerst. Nur für Ihre Anwendung sichtbar.

source
enum<string>

directory für einen gemeinsam genutzten Verzeichniseintrag, added_by_you für Ihren anwendungsinternen Eintrag oder didit_network für einen Verzeichniseintrag, der mit einem Didit-Kunden verknüpft ist. Gesonderte Mitgliedsergebnisse mit kind=didit können dieses Feld auslassen; verwenden Sie kind, um sie zu identifizieren.

Verfügbare Optionen:
didit_network,
directory,
added_by_you
Zuletzt geändert am 12. November 2026