Vai al contenuto principale
POST
curl

Parametri del percorso

token
string
obbligatorio

Token di sessione opaco restituito quando la sessione del widget è stata creata.

Corpo

application/json
method
enum<string>
obbligatorio

Il metodo di prova scelto dall'utente finale. Deve essere uno dei allowed_methods del contesto.

Opzioni disponibili:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

Assume come valore predefinito il wallet_address della sessione. Deve corrispondere al wallet del trasferimento quando la sessione è collegata a un trasferimento.

Maximum string length: 128
chain
string

Assume come valore predefinito la rete della sessione.

Maximum string length: 32

Risposta

La prova già aperta per questo metodo, ripresa.

proof_id
string<uuid>
method
enum<string>
Opzioni disponibili:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING: l'utente finale ha scelto questo metodo e la prova non è ancora decisa. Una firma non riuscita o un deposito di prova non ancora leggibile o confermato mantiene la prova in stato PENDING con un failure_reason, consentendo all'utente finale di riprovare; un deposito SATOSHI_TEST inviato viene ricontrollato automaticamente fino alla chiusura della relativa finestra temporale, mentre uno SCREENSHOT inviato rimane in attesa della tua revisione. VERIFIED: l'assetto proprietario è dimostrato. REJECTED: il deposito di prova è effettivamente errato (un altro mittente, importo non corrispondente a quello previsto verso l'indirizzo di deposito, anteriore alla richiesta di verifica o transazione che ha già provato un altro wallet) oppure il tuo revisore ha rifiutato lo screenshot; failure_reason specifica quale. Una prova rifiutata è definitiva e consuma uno dei tentativi della sessione. EXPIRED: la prova non può più essere decisa (la finestra temporale si è chiusa, l'utente finale ha cambiato metodo, la sessione del widget è scaduta o il titolare del wallet è cambiato); failure_reason specifica quale.

Opzioni disponibili:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

Identificatore canonico della rete blockchain della voce della rubrica a cui si riferisce la prova, ad es. ETH, BTC, SOL, TRX.

deposit_address
string | null

Indirizzo di deposito a cui il cliente deve inviare l'importo del test Satoshi. Presente solo su una prova SATOSHI_TEST.

expected_amount
string | null

Importo on-chain esatto, nella valuta nativa del deposito, a cui il deposito di test Satoshi deve corrispondere. Presente solo su una prova SATOSHI_TEST.

expires_at
string<date-time> | null

Scadenza per la finestra del Satoshi test di questa prova. Presente solo su una prova SATOSHI_TEST; il valore expires_at della sessione del widget viene esteso per coprirla quando viene offerto SATOSHI_TEST.

challenge
string | null

Messaggio emesso da Didit che il cliente firma con il proprio wallet. Presente solo in una prova MESSAGE_SIGNING.

rejection_reason
string

Il motivo per cui la prova è stata rifiutata, come frase in inglese per l'utente finale. Presente solo quando status è REJECTED; vuoto quando il tuo revisore ha rifiutato uno screenshot (la tua nota rimane visibile solo a te).

created_at
string<date-time>
attempts
integer

Quante volte sono state inviate prove per questa prova (firme, ID di transazione, caricamenti).

failure_reason
enum<string>

Perché l'ultimo tentativo non è andato a buon fine, o perché la prova si è conclusa. Vuoto se non si è verificato alcun errore.

Opzioni disponibili:
,
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
Ultima modifica il 7 novembre 2026