Saltar para o conteúdo principal
POST
curl

Parâmetros de caminho

token
string
obrigatório

Token de sessão opaco devolvido quando a sessão do widget foi gerada.

Corpo

application/json
method
enum<string>
obrigatório

O método de comprovativo escolhido pelo utilizador final. Deve ser um dos allowed_methods do contexto.

Opções disponíveis:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

Assume por predefinição o wallet_address da sessão. Tem de corresponder à carteira da transferência quando a sessão estiver associada a uma transferência.

Maximum string length: 128
chain
string

Assume por predefinição a blockchain da sessão.

Maximum string length: 32

Resposta

O comprovativo já aberto para este método, retomado.

proof_id
string<uuid>
method
enum<string>
Opções disponíveis:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING: o utilizador final escolheu este método e a prova ainda não foi decidida. Uma assinatura com falha ou um depósito de teste que ainda não seja legível ou confirmado mantém a prova PENDING com um failure_reason, para que o utilizador final possa tentar novamente; um depósito SATOSHI_TEST submetido é verificado novamente de forma automática até que a respetiva janela termine, e uma SCREENSHOT submetida aguarda a sua revisão. VERIFIED: a propriedade está comprovada. REJECTED: o depósito de teste está comprovadamente incorreto (outro ordenante, valor diferente do esperado para o endereço de depósito, mais antigo do que o desafio ou uma transação que já provou outra carteira) ou o seu revisor rejeitou a captura de ecrã; failure_reason indica o motivo. Uma prova rejeitada é definitiva e consome uma das tentativas da sessão. EXPIRED: a prova já não pode ser decidida (a janela fechou, o utilizador final mudou de método, a sessão do widget expirou ou o titular da carteira mudou); failure_reason indica o motivo.

Opções disponíveis:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

Identificador canónico da blockchain da entrada do livro de endereços a que a prova se refere, por exemplo, ETH, BTC, SOL, TRX.

deposit_address
string | null

Endereço de depósito para o qual o cliente deve enviar o montante do teste Satoshi. Presente apenas num comprovativo SATOSHI_TEST.

expected_amount
string | null

Montante exato on-chain, na moeda nativa do depósito, com o qual o depósito de teste Satoshi deve corresponder. Presente apenas num comprovativo SATOSHI_TEST.

expires_at
string<date-time> | null

Prazo para a janela do teste de Satoshi deste comprovativo. Presente apenas num comprovativo SATOSHI_TEST; o expires_at da própria sessão do widget é prolongado para cobri-lo quando SATOSHI_TEST é disponibilizado.

challenge
string | null

Mensagem emitida pela Didit que o cliente assina com a sua carteira. Presente apenas num comprovativo MESSAGE_SIGNING.

rejection_reason
string

O motivo pelo qual a prova foi recusada, como uma frase em inglês para o utilizador final. Presente apenas quando status é REJECTED; vazio quando o seu revisor recusou uma captura de ecrã (a sua nota permanece consigo).

created_at
string<date-time>
attempts
integer

Quantas vezes foram submetidas provas para este comprovativo (assinaturas, IDs de transação, carregamentos).

failure_reason
enum<string>

O motivo pelo qual a última tentativa falhou ou a prova foi encerrada. Vazio quando nada falhou.

Opções disponíveis:
,
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
Última modificação em 7 de novembro de 2026