Saltar para o conteúdo principal
POST
curl

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json
wallet_address
string

O endereço de carteira a verificar. Opcional; quando vazio, o endereço deve ser fornecido quando uma prova for iniciada.

Maximum string length: 128
chain
string

Token da blockchain para o endereço, por exemplo ETH, BTC ou SOL. Use o mesmo token do seu livro de endereços de carteiras. A assinatura de mensagens e o teste Satoshi são disponibilizados apenas para uma blockchain suportada. A entrada do livro de endereços que a prova verifica armazena-o sob o seu identificador canónico (ETH, BTC, SOL, TRX).

Maximum string length: 32
holder_name
string

Nome do titular da carteira, utilizado para a correspondência de nome do beneficiário.

Maximum string length: 255
vendor_data
string

O seu identificador interno para o titular, associado à entrada do livro de endereços criada.

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

Opcional. UUID da transação Didit de uma transferência Travel Rule a avançar quando a prova for verificada.

satoshi_deposit_address
string

Opcional. Um endereço de depósito que controla; fornecê-lo ativa o método de prova SATOSHI_TEST.

Maximum string length: 128
callback_url
string

Opcional. URL absoluto http(s) para onde o widget devolve o cliente após a conclusão.

Maximum string length: 512
expires_in_minutes
integer
padrão:60

Opcional. Duração da ligação gerada, em minutos. Automaticamente estendida para cobrir a janela do teste Satoshi quando SATOSHI_TEST é disponibilizado.

Intervalo necessário: 5 <= x <= 10080

Resposta

A sessão de widget gerada.

widget_session_id
string<uuid>
token
string

Token de sessão opaco incorporado no URL do widget.

url
string

O URL do widget alojado de comprovação de propriedade da carteira. Abra-o exatamente como fornecido no navegador do sistema (nunca dentro de uma webview de SDK móvel).

expires_at
string<date-time>
Última modificação em 7 de novembro de 2026