Pular para o conteúdo principal
POST
curl

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, 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á errada, 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 a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json
wallet_address
string

O endereço da carteira a ser verificado. Opcional; quando vazio, o endereço deve ser informado ao iniciar uma prova.

Maximum string length: 128
chain
string

Token da rede (chain) do endereço, por exemplo ETH, BTC ou SOL. Use o mesmo token do catálogo de endereços de carteiras. A assinatura de mensagem e o teste Satoshi são oferecidos apenas para uma rede compatível. A entrada do catálogo de endereços que a prova verifica o armazena com seu identificador canônico (ETH, BTC, SOL, TRX).

Maximum string length: 32
holder_name
string

Nome do titular da carteira, usado na correspondência do nome do beneficiário.

Maximum string length: 255
vendor_data
string

Seu identificador interno para o titular, transferido para a entrada criada no catálogo de endereços.

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

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

satoshi_deposit_address
string

Opcional. Um endereço de depósito que você controla; informá-lo habilita o método de comprovação SATOSHI_TEST.

Maximum string length: 128
callback_url
string

Opcional. URL http(s) absoluta para a qual o widget retorna o cliente após a conclusão.

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

Opcional. Tempo de vida do link gerado, em minutos. É estendido automaticamente para cobrir a janela do teste de Satoshi quando SATOSHI_TEST é oferecido.

Intervalo obrigatório: 5 <= x <= 10080

Resposta

A sessão de widget emitida.

widget_session_id
string<uuid>
token
string

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

url
string

A URL do widget hospedado de propriedade da carteira. Abra-a exatamente como está no navegador do sistema (nunca dentro de uma webview de SDK móvel).

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