Começar
Integrar / SDKs
Verificação de utilizadores
Verificação de empresas
Monitorização de transações
Registo de alteraçõesQuando utilizar
A triagem de carteiras não grava nada na tabela de transações. Se precisar que a triagem fique associada a uma transação monitorizada (com regras, alertas e webhooks), submeta uma transação.
Pré-requisitos
A monitorização de transações tem de estar configurada para a aplicação, com um fornecedor gerido ou uma chave de fornecedor existente. Configure-a em Transações > Definições > Preferências do fornecedor na Business Console. Se nenhum fornecedor estiver configurado, o endpoint devolve409 Conflict.
Pedido
POST https://verification.didit.me/v3/wallet-screening/
Autentique-se com o cabeçalho x-api-key.
Cobertura de redes
A triagem gerida suporta Base (BASE), Optimism (OP) e Arbitrum One (ARB), tanto para triagem de carteiras como de hashes de transações.
Os fornecedores ligados podem ter cobertura diferente; uma rede também tem de ser suportada pelo fornecedor e pela conta selecionados.
Celo (CELO), Mode (MODE) e Plume (PLUME) são analisadas através de uma conta TRM Labs ligada (Marketplace, traga a sua própria chave); a análise gerida não as cobre e responde com 400.
Não envie ETH para outra rede EVM: o mesmo endereço pode ter atividade e risco diferentes em cada rede.
Com a análise gerida, USDT e USDC são aliases antigos para Ethereum, e não uma pesquisa em todas as redes onde esses tokens existem.
Use o identificador da rede (ETH, TRX, SOL, MATIC, BNB, BASE, OP, ARB, AVAX, ADA, XLM, HBAR, ou, com TRM Labs, CELO, MODE ou PLUME) correspondente à rede real da carteira.
Para tokens em transações registadas, mantenha o token em transaction_details.currency e indique a rede separadamente em transaction_details.crypto_params.crypto_chain.
Consulte seleção de ativo e rede.
Resposta
A resposta é o resultado de triagem normalizado, com a mesma estrutura do resultado do fornecedorWALLET_SCREENING devolvido pela triagem de transações.
Como
severity é definido. severity é a faixa do risk_score normalizado: 0-9 → UNKNOWN, 10-39 → LOW, 40-69 → MEDIUM, 70-89 → HIGH, 90-100 → CRITICAL. UNKNOWN é a faixa mais baixa, não um estado separado de “sem dados”: risk_score: 0 (o caso comum de um endereço limpo) significa que o fornecedor não devolveu nenhuma avaliação adversa, enquanto uma pontuação diferente de zero no intervalo 1-9 é um sinal real, mas abaixo de LOW; por isso, leia o próprio risk_score e não apenas a faixa. Em qualquer dos casos, não apresente UNKNOWN como um «limpo» nem como uma aprovação afirmativa.direction não altera o modelo de risco. O campo opcional direction é enviado ao fornecedor apenas como contexto. Não afeta risk_score, severity nem as listas de detalhe devolvidas: tanto source_of_funds como destination_of_funds são sempre devolvidos, independentemente disso. Alterar ou omitir direction não obriga, portanto, a repetir a triagem de um endereço já analisado.Fatores de risco
risk_factors é a resposta ordenada à pergunta “porque é que este endereço tem esta pontuação”. Os fornecedores classificam um endereço com o seu próprio modelo e devolvem apenas um veredito (a Merkle Science devolve um inteiro 0-5), pelo que risk_score por si só não permite tomar medidas. Cada entrada identifica um fator; as entradas são ordenadas primeiro pelos fatores de alto risco e, depois, pelo valor que passou por cada fator.
Uma pontuação alta sem nenhum fator
is_high_risk é um resultado real e significativo. Significa que o fornecedor classificou o endereço com base no seu próprio modelo de exposição, sem reportar uma correspondência com sanções, com uma PEP ou com uma entidade atribuída: os fatores listados são os fluxos de fundos que sustentam a classificação. summary declara isto explicitamente, por isso trate estes endereços como “rever os fluxos”, e não como uma correspondência confirmada. risk_factors está limitado aos cinco fatores mais fortes; source_of_funds e destination_of_funds contêm sempre o detalhe completo.risk_factors é um campo de nível superior, não aninhado. Os resultados analisados antes da existência deste campo omitem a chave por completo: leia-a como uma lista vazia, em vez de assumir uma explicação vazia.Detalhe da exposição
Cada entrada emsource_of_funds / destination_of_funds descreve uma entidade com a qual o endereço trocou fundos:
Ligações com contrapartes
counterparty_connections lista as entidades às quais o fornecedor atribui o endereço analisado. Na Merkle Science, estas provêm das etiquetas de proprietário e de utilizador do próprio endereço, pelo que a mesma entidade pode aparecer duas vezes, e não incluem fluxos de fundos: received_usd, sent_usd, received_hops e sent_hops são null, e percentage é 0.0. Leia os fluxos de fundos em source_of_funds e destination_of_funds.
Exemplo
Uma resposta real para um endereço na lista de sanções OFAC, analisado com a Merkle Science. Sóraw_response foi encurtado e report_signature foi substituído:
sanctions_hit: true pode indicar que a própria carteira está sancionada ou apenas que os seus fundos têm exposição a sanções, pelo que não significa, por si só, que o titular da carteira analisada esteja sancionado.
Quando a mesma triagem é executada sobre uma transação registada, as regras podem também ler custom_values.wallet_sanctioned, que é true apenas quando o fornecedor atribui a própria carteira a uma entidade sancionada, e custom_values.aml_sanctions_exposure_pct.
Consulte Campos de triagem para regras.
Leia risk_factors, source_of_funds e destination_of_funds para distinguir atribuição de exposição.
Consulte Triagem de cripto e carteiras para um guia passo a passo.
Relatório PDF
Para obter um PDF com a marca Didit de um resultado de triagem, reenvie o corpo exato da resposta, incluindoreport_signature, para POST /v3/wallet-screening/pdf/. Esta operação não tem estado: não há chamadas ao fornecedor, não há faturação adicional e nada é guardado. Editar qualquer campo assinado (risk_score, severity, sanctions_hit, …) antes de reenviar falha com 400.
Billing
Cada utilização de monitorização AML é faturada por triagem bem-sucedida, à mesma tarifa da triagem cripto associada a transações. Consulte os preços das tarifas com chave gerida e com chave ligada. As aplicações em sandbox não são faturadas. Os erros de validação (400) e os erros de fornecedor não configurado (409) nunca são faturados.
Erros
Próximos passos
Referência da API
Esquema completo do pedido e da resposta do endpoint Screen Wallet.
PDF Screen Wallet
Gere o resultado de uma triagem como PDF com a marca Didit.
Triagem cripto e de carteiras
Triagem automática durante a criação de transações e o modelo de resultados.