Blog · 21 de maio de 2026

KYT para Câmbios e On-Ramps de Cripto: Um Guia de Implementação (PT-BR)

Um guia prático para integrar a triagem de carteiras em uma exchange ou on-ramp de cripto — analisando depósitos e saques no momento certo, codificando políticas e gerenciando alertas — por US$0,02 por triagem com BYOK.

Por Didit21 de maio de 2026Atualizado 21 de mai. de 2026

Uma exchange ou on-ramp de cripto tem exatamente dois momentos em que o risco on-chain entra ou sai do negócio: um depósito entra e uma retirada sai. Acertar a triagem nesses dois pontos cobre o cerne do Know Your Transaction (KYT). Errar — triar tarde demais, triar o item errado ou tratar cada correspondência como um ticket manual — e você aceita fundos contaminados ou sobrecarrega seus analistas.

Este é um guia de implementação para integrar o Wallet Screening da Didit em um fluxo de depósito/retirada. Ele aborda onde realizar a triagem, como codificar a política para que a maioria das decisões seja automática e como lidar com as que não são — tudo na API unificada /v3/ por US$0,02 por triagem com bring-your-own-key (BYOK).

Principais pontos

Dois pontos de triagem: triar o endereço de depósito na entrada e o endereço de destino na saída.
Bloqueie antes da liquidação. A triagem pré-transferência permite recusar um depósito ou bloquear uma retirada antes que o valor seja movimentado.
Codifique a política como regras para que LOW/MEDIUM passem automaticamente, HIGH seja encaminhado para revisão e CRITICAL seja recusado — analistas só lidam com casos extremos.
Registros pós-transferência por hash de transação mantêm uma trilha de auditoria e capturam designações de sanções retroativas.
Gerenciamento de casos integrado + fluxo de trabalho SAR — alertas abrem no mesmo Console, sem ferramenta separada.
US$0,02 por triagem com BYOK (Crystal ou Merkle Science); pagamento por chamada, sem mínimos.

O que KYT significa para uma exchange

KYC verifica quem é seu usuário no onboarding. KYT monitora o que o dinheiro deles faz depois — especificamente, de onde veio a cripto que depositam e para onde vai a cripto que retiram. Para uma exchange ou on-ramp, a obrigação é concreta: não aceitar fundos com exposição a sanções, mixers, darknet, ransomware ou fundos roubados, e não enviar fundos para carteiras com as mesmas características. A triagem de carteira é o mecanismo que impõe isso transação por transação.

Por que isso importa

Depósitos e saques são as únicas duas portas que o valor utiliza, então são as únicas duas portas que o risco utiliza. Um depósito contaminado aceito é uma exposição de lavagem de dinheiro em seus registros; um saque enviado para uma carteira sancionada é uma violação de sanções, independentemente da intenção. A expectativa regulatória para VASPs é um monitoramento contínuo explícito de transações, e a expectativa prática é que você detecte isso antes da liquidação, e não em uma revisão de fim de mês.

A razão pela qual as equipes historicamente faziam menos triagens era o custo: assinaturas legadas de análise de blockchain precificavam a triagem como um contrato empresarial. Com US$0,02 por triagem com BYOK, essa restrição desapareceu — você pode triar cada depósito e cada saque e ainda assim sair aproximadamente 10 vezes mais barato do que comprar os dados diretamente.

Detalhes técnicos

Tudo funciona em POST /v3/transactions/. Defina currency_kind: "crypto", uma direção e o endereço que você está triando.

Depósito (INBOUND) — triar o endereço de origem antes de creditar:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "dep_a31f",
    "category": "finance",
    "amount": 8000,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x12ab...90cd",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_2201", "role": "RECEIVER" }
  }'

Saque (OUTBOUND) — triar o destino antes de liberar:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "wd_b58c",
    "category": "finance",
    "amount": 8000,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "OUTBOUND",
    "wallet_address": "0x44de...11ff",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_2201", "role": "SENDER" }
  }'

Ramifique com base no "band" do veredito:

{
  "transaction_id": "wd_b58c",
  "status": "APPROVED",
  "wallet_screening": {
    "risk_score": 12,
    "risk_band": "LOW",
    "exposure": [ { "category": "EXCHANGE", "type": "DIRECT", "share": 0.96 } ]
  }
}

Após a liquidação, trie a transação confirmada por hash (payment_reference_id) para manter um registro pós-transferência auditável.

Webhooks. Assine transaction.status.updated para que seu livro-razão reflita as decisões do analista e qualquer remediação AWAITING_USER.

Preço. US$0,02 por triagem com BYOK (Crystal ou Merkle Science), por chamada, sem mínimos.

Um fluxo de referência

Solicitação de depósito
   └─ POST /v3/transactions/ (ENTRADA, wallet_address, triagem)
        ├─ BAIXO / MÉDIO → credita o depósito
        ├─ ALTO          → retém; abre alerta; analista revisa
        └─ CRÍTICO       → rejeita; congela; abre alerta; considera SAR

Solicitação de saque
   └─ POST /v3/transactions/ (SAÍDA, wallet_address de destino, triagem)
        ├─ BAIXO / MÉDIO → libera
        ├─ ALTO          → retém; analista revisa
        └─ CRÍTICO       → bloqueia; abre alerta

Pós-liquidação
   └─ POST /v3/transactions/ (hash como payment_reference_id) → registro de auditoria

Codifique o tratamento LOW/MEDIUM/HIGH/CRITICAL uma vez no pacote de regras de Triagem de cripto para que o status retorne já decidido — seu backend apenas age sobre ele.

Casos de uso

Exchanges centralizadas — trie cada depósito e saque; recuse CRÍTICO automaticamente, enfileire ALTO, registre o restante.
On/off-ramps — bloqueie conversões fiat↔cripto na carteira da contraparte antes de liquidar para os trilhos bancários.
Corretoras adicionando cripto — reutilize uma integração existente de monitoramento de transações; a triagem de cripto é o mesmo endpoint.
Custodiantes — trie na entrada e re-trie no movimento, com o grafo de rede como prova de congelamento.
VASPs — combine KYT com a troca de dados da Regra de Viagem do FATF no mesmo motor para risco de contraparte de ponta a ponta.

Como integrar com a Didit

Configure o provedor + padrão. Em Console → Transações → Configurações, defina Crystal ou Merkle Science (BYOK ou gerenciado) e o comportamento de triagem padrão.
Escreva as regras de política. Ative o pacote de triagem de cripto e defina bandas → ações para que a maioria das decisões seja automática.
Trie em ambas as portas. Chame POST /v3/transactions/ para cada depósito (INBOUND) e saque (OUTBOUND) antes da liquidação.
Registre após a liquidação. Re-trie a transação confirmada por hash para a trilha de auditoria.
Trabalhe os casos extremos. Triagens ALTO/CRÍTICO abrem alertas; investigue, escale para um caso e registre SARs no mesmo Console.

Como tudo está na API unificada /v3/, o mesmo usuário que deposita passa pelo monitoramento de transações, uma transação sinalizada pode ser pausada via AWAITING_USER e acionar uma etapa de remediação, e KYC, KYT e AML se combinam em uma única plataforma de identidade e fraude.

Perguntas frequentes

Onde exatamente devo fazer a triagem?

Em dois pontos: o endereço de origem de cada depósito (INBOUND) antes de creditar, e o endereço de destino de cada saque (OUTBOUND) antes de liberar. Adicione a triagem pós-transferência por hash para registros.

Triar cada transação não será caro?

Não. A US$0,02 por triagem com BYOK — aproximadamente 10 vezes mais barato do que comprar análises diretamente — triar cada depósito e saque é acessível, mesmo em alto volume.

Como evito a revisão manual em cada correspondência?

Codifique a política no pacote de regras de triagem de cripto para que LOW/MEDIUM passem automaticamente, HIGH seja encaminhado para um analista e CRITICAL seja recusado. Analistas só lidam com os extremos.

Isso também cobre a Regra de Viagem?

Sim. O mesmo motor de Monitoramento de Transações suporta a Regra de Viagem do FATF, então a troca de dados da contraparte e a triagem de carteira funcionam juntas.

Quais provedores posso usar?

Crystal e Merkle Science hoje (BYOK ou gerenciado); Chainalysis e Elliptic estão chegando em breve a US$0,02 BYOK.

Pronto para começar?

Leia a visão geral de Wallet Screening na documentação, veja como ele se encaixa na plataforma na página do produto Wallet Screening e verifique os preços por chamada na página de preços. Quando estiver pronto, comece gratuitamente — 500 verificações KYC gratuitas todos os meses e triagem de carteira a US$0,02 por triagem com BYOK.