Zum Hauptinhalt springen
POST
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
wallet_address
string

Die zu verifizierende Adresse. Optional; wenn leer, muss die Adresse angegeben werden, sobald ein Nachweis gestartet wird.

Maximum string length: 128
chain
string

Chain-Token für die Adresse, zum Beispiel ETH, BTC oder SOL. Verwenden Sie dasselbe Token wie in Ihrem Wallet-Adressbuch. Das Signieren von Nachrichten und der Satoshi-Test werden nur für eine unterstützte Chain angeboten. Der Adressbucheintrag, den der Nachweis verifiziert, speichert diesen unter seiner kanonischen Kennung (ETH, BTC, SOL, TRX).

Maximum string length: 32
holder_name
string

Name des Wallet-Inhabers, der für den Abgleich des Begünstigtennamens verwendet wird.

Maximum string length: 255
vendor_data
string

Ihre interne Kennung für den Inhaber, die in den erstellten Adressbucheintrag übernommen wird.

Maximum string length: 255
transaction_id
string<uuid> | null

Optional. Didit-Transaktions-UUID eines Travel-Rule-Transfers, der fortgeführt werden soll, wenn der Nachweis verifiziert wird.

satoshi_deposit_address
string

Optional. Eine von Ihnen kontrollierte Einzahlungsadresse; ihre Angabe aktiviert die Nachweismethode SATOSHI_TEST.

Maximum string length: 128
callback_url
string

Optional. Absolute http(s)-URL, zu der das Widget den Kunden nach Abschluss zurückleitet.

Maximum string length: 512
expires_in_minutes
integer
Standard:60

Optional. Gültigkeitsdauer des erstellten Links in Minuten. Wird automatisch verlängert, um das Zeitfenster für den Satoshi-Test abzudecken, wenn SATOSHI_TEST angeboten wird.

Erforderlicher Bereich: 5 <= x <= 10080

Antwort

Die erstellte Widget-Sitzung.

widget_session_id
string<uuid>
token
string

Opakes Sitzungs-Token, das in die Widget-URL eingebettet ist.

url
string

Die gehostete URL des Wallet-Eigentums-Widgets. Öffnen Sie sie unverändert im System-Browser (niemals innerhalb einer mobilen SDK-Webview).

expires_at
string<date-time>
Zuletzt geändert am 7. November 2026