Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alteraçõesComo a triagem é acionada
A triagem de cripto é executada automaticamente quando as duas condições são atendidas:- A transação tem
currency_kind: "crypto"nos detalhes da transação - O monitoramento de transações está ativado nas configurações da aplicação
include_crypto_screening no payload de criação da transação:
Seleção de ativo e rede
O ativo e a rede são campos separados. Definatransaction_details.currency como o símbolo do token, transaction_details.currency_kind como crypto e transaction_details.crypto_params.crypto_chain como a rede.
Por exemplo, este trecho registra um token personalizado na Base:
BTC, ETH, LTC, XRP, BCH, DOGE, TRX, SOL, MATIC, BNB, BASE, OP, ARB, AVAX, ADA, XLM e HBAR.
BASE significa Base, OP significa Optimism, ARB significa Arbitrum One, AVAX significa Avalanche C-Chain, ADA significa Cardano, XLM significa Stellar e HBAR significa Hedera.
Nomes comuns de redes também são aceitos, por exemplo POLYGON ou POL para MATIC, BSC para BNB e TRON para TRX.
Celo, Mode e Plume não são cobertas pela integração gerenciada; elas são analisadas por meio de uma conta TRM Labs conectada (CELO, MODE, PLUME).
Os provedores conectados têm a própria cobertura; a Lightning tem requisitos adicionais, descritos abaixo.
Sempre especifique crypto_chain para um token, inclusive USDT e USDC.
Sem ele, a moeda é usada como rede, e USDT e USDC obtêm a rede a partir do hash da transação ou, sem hash, a partir do endereço da carteira.
Um hash da Tron ou da Solana seleciona Tron ou Solana.
Um hash 0x tem a mesma aparência em todas as redes EVM, então, para USDT, USDC e ETH, a Didit o procura em Ethereum, BNB Chain, Polygon, Base, Arbitrum e Optimism e analisa a transação na rede em que ele for encontrado.
O ETH está incluído porque é nativo em Ethereum, Base, Arbitrum e Optimism e também é transferido na BNB Chain como um token BEP-20 bridged.
Se nenhuma rede tiver o hash, ou se não for possível verificar as redes naquele momento, a transação não é analisada e a triagem não é cobrada.
Nesse caso, custom_values.aml_screening_status fica como FAILED, custom_values.aml_screening_error informa o motivo e uma transação aprovada passa para revisão.
Uma transação em USDT ou USDC sem hash analisa uma carteira, e o endereço da carteira seleciona a rede.
Um endereço da Tron é analisado na Tron e um endereço da Solana, na Solana.
Um endereço 0x é analisado na primeira rede, entre Ethereum, BNB Chain, Polygon, Base, Arbitrum e Optimism, em que ele tenha enviado uma transação ou detenha o token.
Um endereço 0x sem atividade em nenhuma delas, ou cujas redes não possam ser verificadas naquele momento, é analisado na Ethereum.
Enviar crypto_chain evita a busca.
Nunca use ETH no lugar da rede real.
Registrar um símbolo de token personalizado não garante que as transferências dele sejam indexadas para a triagem por hash de transação.
A cobertura do token deve ser verificada usando o contrato do token e a rede.
Uma transação criada não é prova de triagem bem-sucedida: verifique o status da triagem e o resultado do provedor antes de considerá-la analisada.
Entrada vs. saída
transaction_details.direction é obrigatório porque informa à Didit qual lado da transferência deve ser analisado.
Para a triagem antes da transferência, omita
transaction_details.payment_reference_id; a Didit executa a triagem do endereço da carteira relevante. Para a triagem depois da transferência, inclua o hash da transação na blockchain em transaction_details.payment_reference_id; a Didit executa a triagem da transação e armazena dados de resumo da transação quando o enriquecimento on-chain está disponível.
Lightning Network
Definatransaction_details.crypto_params.crypto_chain como LIGHTNING para a triagem na Lightning Network.
A triagem na Lightning exige um provedor BYOK da Elliptic ou da Chainalysis conectado no Marketplace do console.
Merkle Science, Crystal e TRM Labs gerenciados não aceitam LIGHTNING; a Didit recusa essas requisições com 400 antes da triagem ou do faturamento.
Com a Elliptic, a Didit analisa o identificador Lightning informado por meio da análise de carteiras BTC Lightning da Elliptic.
Com a Chainalysis, a Didit envia uma transferência Lightning ao KYT quando transaction_details.payment_reference_id está presente.
Campos obrigatórios
Em todas as requisições de análise de cripto, envie:transaction_details.direction—INBOUNDouOUTBOUNDtransaction_details.currency_kind—cryptotransaction_details.currency— o símbolo do ativo, por exemploBTC,ETH,USDCou seu token personalizado- Um endereço de carteira autocustodiada no participante selecionado pelas regras de direção acima
transaction_details.payment_reference_id— o hash da transação na blockchain
Exemplo: análise de saída antes da transferência
Antes de enviar fundos, crie uma transação de criptomoeda de saída sem hash de transação. A Didit analisa a carteira de destino.Exemplo: análise de transação de entrada após a transferência
Depois de receber fundos, inclua o hash da transação. A Didit analisa o hash da transação considerando seu endereço de depósito e complementa a resposta com informações resumidas da transação, quando disponíveis.Provedores compatíveis
Configure seu provedor preferido em Transactions > Settings > Provider Preferences no Business Console, ou conecte sua própria chave de API do provedor no Marketplace do console (categoria Crypto monitoring).
LIGHTNING é compatível apenas com as configurações de Chainalysis e Elliptic com chave conectada.
Resultados da triagem
Cada triagem produz um resultado padronizado, independentemente do provedor utilizado.Status da triagem
custom_values.aml_screening_status indica se uma transação foi analisada.
Uma transação que seria aprovada passa para
IN_REVIEW enquanto a triagem estiver em qualquer status diferente de COMPLETED.
Hashes de transação ainda não indexados
Um provedor de análise de blockchain pode levar alguns minutos para indexar uma transferência recém-minerada e, até lá, não consegue analisá-la. Quando o provedor responde que ainda não indexou um hash de transação, e a própria rede confirma que a transação existe, a Didit a analisa novamente em segundo plano em vez de marcá-la como falha:- A resposta de criação já mostra
custom_values.aml_screening_statuscomoPENDING, com o motivo emcustom_values.aml_screening_error. Uma transação que, de outra forma, seria aprovada fica retida emIN_REVIEWcomdecision_reason_codeaml_screening_pending. - A Didit analisa o hash da transação novamente cerca de 2, 12 e 42 minutos após a criação da transação.
- Quando uma nova tentativa consegue analisá-la, o resultado é armazenado como em qualquer outra triagem e a triagem é cobrada uma única vez.
Suas regras são executadas novamente sobre os dados da triagem, a retenção é liberada e você recebe um webhook
transaction.status.updatedcom o status que a transação tem após as regras, tenha ele mudado ou não. Uma transação que foi recusada ou resolvida por um revisor nesse meio-tempo mantém o seu status. - Se o provedor ainda não tiver indexado o hash da transação após a última tentativa, a triagem termina como
FAILED, como teria terminado na criação: a transação permanece emIN_REVIEWcomdecision_reason_codeaml_screening_failed, e a cobrança é a mesma de uma falha na criação: nada na triagem gerenciada pela Didit, uma requisição ao provedor quando a última tentativa chegou ao seu provedor conectado. As tentativas anteriores que exigiram nova tentativa nunca são cobradas. - Se o seu saldo não puder mais cobrir a triagem quando uma nova tentativa for executada, a triagem termina como
FAILEDe nada é cobrado.
Pontuação de risco e severidade
Cada carteira ou transação analisada recebe:- Pontuação de risco (0–100) — pontuações mais altas indicam maior exposição a entidades de risco
- Nível de severidade — derivado da pontuação:
LOW,MEDIUM,HIGHouCRITICAL
Análise da origem dos recursos
Uma divisão percentual de onde os recursos se originaram, categorizada por tipo de entidade:
Cada entidade na divisão inclui o percentual dos recursos, os valores recebidos e enviados e se a conexão é direta ou indireta.
Tabela de exposição
Uma tabela de exposição que mostra as entidades de origem, de destino e contrapartes, incluindo:- Nome e categoria da entidade
- Conexão direta ou indireta (número de saltos)
- Valores recebidos e enviados
- Nível de risco por entidade
Grafo de rede
Uma representação visual em nós e arestas das relações de transação da carteira:- Nós representam carteiras, exchanges, serviços e outras entidades
- Arestas representam transações entre nós, com valores e hashes de transação
- Métricas incluem estatísticas do grafo, como centralidade e profundidade
Integração com regras
Os resultados da análise alimentam diretamente o mecanismo de regras. A Didit inclui regras predefinidas que são acionadas automaticamente com base nos dados da análise:Campos de análise para regras
A análise de cripto grava estas chaves nocustom_values da transação, para que as regras possam usá-las como custom_values.<key>:
Use
wallet_sanctioned para bloquear transferências para uma carteira sancionada sem recusar transferências para grandes exchanges que tenham apenas exposição indireta.
Use sanctions_hit ou aml_sanctions_exposure_pct para revisar ou pontuar a exposição.
A regra predefinida Sanctions counterparty recusa quando wallet_sanctioned é true, e a regra predefinida Exposição a sanções envia para revisão as carteiras que têm apenas exposição.
As duas nunca são aplicáveis à mesma transação, então uma carteira sancionada é sempre recusada.
Se você instalou a Sanctions counterparty antes dessa mudança, a Didit a migrou para wallet_sanctioned por você e adicionou a Exposição a sanções no mesmo modo, de modo que uma transferência que a regra antiga recusava apenas por exposição agora vai para revisão.
Após a conclusão da análise, a Didit reavalia automaticamente todas as regras com os dados enriquecidos da transação e dispara os webhooks aplicáveis.
Próximos passos
Envio de transações
Como enviar transações, incluindo os detalhes da carteira de criptomoedas.
Regras e pontuação
Como os resultados da triagem alimentam o mecanismo de regras.
Guia do console
Como visualizar no console a análise de triagem de cripto, a origem dos recursos e os grafos de rede.