Zum Hauptinhalt springen
POST
curl

Pfadparameter

token
string
erforderlich

Opakes Sitzungs-Token, das zurückgegeben wird, wenn die Widget-Sitzung erstellt wurde.

Body

application/json
method
enum<string>
erforderlich

Die vom Endbenutzer gewählte Nachweismethode. Sie muss eine der allowed_methods des Kontexts sein.

Verfügbare Optionen:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

Standardmäßig die wallet_address der Sitzung. Muss mit der Wallet des Transfers übereinstimmen, wenn die Sitzung mit einem Transfer verknüpft ist.

Maximum string length: 128
chain
string

Standardmäßig die Blockchain der Sitzung.

Maximum string length: 32

Antwort

Der für diese Methode bereits offene Nachweis, wiederaufgenommen.

proof_id
string<uuid>
method
enum<string>
Verfügbare Optionen:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING: Der Endbenutzer hat diese Methode ausgewählt und der Nachweis ist noch nicht entschieden. Eine fehlgeschlagene Signatur oder eine Testeinzahlung, die noch nicht lesbar oder bestätigt ist, hält den Nachweis auf PENDING mit einem failure_reason, sodass der Endbenutzer es erneut versuchen kann; eine übermittelte SATOSHI_TEST-Einzahlung wird automatisch erneut geprüft, bis ihr Zeitfenster schließt, und ein übermittelter SCREENSHOT wartet auf Ihre Prüfung. VERIFIED: Die Eigentümerschaft ist nachgewiesen. REJECTED: Die Testeinzahlung ist definitiv falsch (anderer Absender, nicht der erwartete Betrag an die Einzahlungsadresse, älter als die Challenge oder eine Transaktion, die bereits eine andere Wallet nachgewiesen hat) oder Ihr Prüfer hat den Screenshot abgelehnt; failure_reason gibt den Grund an. Ein abgelehnter Nachweis ist endgültig und verbraucht einen der Versuche der Sitzung. EXPIRED: Über den Nachweis kann nicht mehr entschieden werden (Zeitfenster abgelaufen, Endbenutzer hat die Methode gewechselt, Widget-Sitzung abgelaufen oder Inhaber der Wallet hat sich geändert); failure_reason gibt den Grund an.

Verfügbare Optionen:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

Kanonischer Chain-Identifikator des Adressbucheintrags, für den der Nachweis bestimmt ist, z. B. ETH, BTC, SOL, TRX.

deposit_address
string | null

Einzahlungsadresse, an die der Kunde den Satoshi-Testbetrag senden muss. Nur bei einem SATOSHI_TEST-Nachweis vorhanden.

expected_amount
string | null

Exakter On-Chain-Betrag in der nativen Währung der Einzahlung, mit dem die Satoshi-Test-Einzahlung übereinstimmen muss. Nur bei einem SATOSHI_TEST-Nachweis vorhanden.

expires_at
string<date-time> | null

Frist für das eigene Satoshi-Testfenster dieses Nachweises. Nur bei einem SATOSHI_TEST-Nachweis vorhanden; das eigene expires_at der Widget-Sitzung wird verlängert, um dieses abzudecken, wenn SATOSHI_TEST angeboten wird.

challenge
string | null

Von Didit ausgestellte Nachricht, die der Kunde mit seiner Wallet signiert. Nur bei einem MESSAGE_SIGNING-Nachweis vorhanden.

rejection_reason
string

Warum der Nachweis abgelehnt wurde, als englischer Satz für den Endbenutzer. Nur vorhanden, wenn status REJECTED ist; leer, wenn Ihr Prüfer einen Screenshot abgelehnt hat (Ihre Notiz verbleibt bei Ihnen).

created_at
string<date-time>
attempts
integer

Wie oft Nachweise für diesen Beleg übermittelt wurden (Signaturen, Transaktions-IDs, Uploads).

failure_reason
enum<string>

Warum der letzte Versuch fehlgeschlagen ist oder warum der Nachweis geschlossen wurde. Leer, wenn nichts fehlgeschlagen ist.

Verfügbare Optionen:
,
SIGNATURE_INVALID,
SIGNATURE_UNSUPPORTED_SCHEME,
DEPOSIT_NOT_FOUND,
DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED,
DEPOSIT_MISMATCH,
DEPOSIT_STALE,
TXID_REUSED,
CHAIN_UNSUPPORTED,
WINDOW_EXPIRED,
OWNERSHIP_CHANGED,
METHOD_SWITCHED,
REVIEW_REJECTED,
ABANDONED
Zuletzt geändert am 7. November 2026