Pular para o conteúdo principal
POST
curl

Parâmetros de caminho

token
string
obrigatório

Token de sessão opaco retornado quando a sessão do widget foi criada.

Corpo

application/json
method
enum<string>
obrigatório

O método de comprovação que o usuário final escolheu. Deve ser um dos allowed_methods do contexto.

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

O padrão é o wallet_address da sessão. Deve corresponder à carteira da transferência quando a sessão estiver vinculada a uma transferência.

Maximum string length: 128
chain
string

O padrão é a blockchain da sessão.

Maximum string length: 32

Resposta

A comprovação já aberta para este método, retomada.

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

PENDING: o usuário final escolheu este método e a prova ainda não foi decidida. Uma assinatura que falhou ou um depósito de teste que ainda não pôde ser lido ou confirmado mantém a prova em PENDING com um failure_reason, para que o usuário final possa tentar novamente; um depósito SATOSHI_TEST enviado é verificado de novo automaticamente até sua janela se encerrar, e um SCREENSHOT enviado aguarda a sua revisão. VERIFIED: a propriedade está comprovada. REJECTED: o depósito de teste está realmente incorreto (outro remetente, valor diferente do esperado para o endereço de depósito, anterior ao desafio ou uma transação que já comprovou outra carteira) ou o seu revisor rejeitou a captura de tela; failure_reason indica qual. Uma prova rejeitada é definitiva e consome uma das tentativas da sessão. EXPIRED: a prova não pode mais ser decidida (sua janela se encerrou, o usuário final trocou de método, a sessão do widget expirou ou o titular da carteira mudou); failure_reason indica qual.

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

Identificador canônico da blockchain da entrada do catálogo de endereços à qual 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 valor de teste em Satoshi. Presente apenas em uma prova SATOSHI_TEST.

expected_amount
string | null

Valor on-chain exato, na moeda nativa do depósito, ao qual o depósito de teste Satoshi deve corresponder. Presente apenas em uma prova SATOSHI_TEST.

expires_at
string<date-time> | null

Prazo da janela do teste Satoshi desta prova. Presente apenas em uma prova SATOSHI_TEST; o expires_at da própria sessão do widget é estendido para cobri-lo quando SATOSHI_TEST é oferecido.

challenge
string | null

Mensagem emitida pela Didit que o cliente assina com a própria carteira. Presente apenas em uma prova MESSAGE_SIGNING.

rejection_reason
string

Por que a comprovação foi rejeitada, como uma frase em inglês para o usuário final. Presente apenas quando status é REJECTED; vazio quando seu revisor rejeitou uma captura de tela (sua observação fica só com você).

created_at
string<date-time>
attempts
integer

Quantas vezes evidências foram enviadas para esta comprovação (assinaturas, IDs de transação, uploads).

failure_reason
enum<string>

Por que a última tentativa não foi suficiente, ou por que a comprovação 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 1 de novembro de 2026