Blog · 21 de maio de 2026

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

Um guia prático para integrar a análise de carteiras numa bolsa de criptomoedas ou plataforma on-ramp — analisando depósitos e levantamentos no momento certo, codificando políticas e gerindo alertas — a 0,02 $ por análise com.

Por Didit21 de maio de 2026Atualizado 21/05/2026

Uma plataforma de câmbio 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 um levantamento sai. Se a análise for feita corretamente nesses dois pontos, cobriu o essencial do Know Your Transaction (KYT). Se for feita incorretamente — analisar demasiado tarde, analisar o errado, ou tratar cada correspondência como um ticket manual — ou aceita fundos contaminados ou sobrecarrega os seus analistas.

Este é um guia de implementação para integrar a Análise de Carteiras da Didit num fluxo de depósito/levantamento. Abrange onde analisar, como codificar a política para que a maioria das decisões sejam automáticas, e como lidar com as que não são — tudo na API unificada /v3/ a 0,02 $ por análise com a sua própria chave (BYOK).

Principais pontos

Dois pontos de análise: analise o endereço de depósito na entrada, analise o endereço de destino na saída.
Controle antes da liquidação. A análise pré-transferência permite recusar um depósito ou bloquear um levantamento antes que o valor se mova.
Codifique a política como regras para que LOW/MEDIUM passem automaticamente, HIGH seja encaminhado para revisão e CRITICAL seja recusado — os analistas apenas lidam com os casos excecionais.
Registos pós-transferência por hash de transação mantêm uma trilha de auditoria e detetam designações de sanções retroativas.
Gestão de casos integrada + fluxo de trabalho SAR — os alertas abrem na mesma Consola, sem ferramenta separada.
0,02 $ por análise com BYOK (Crystal ou Merkle Science); pagamento por chamada, sem mínimos.

O que o KYT significa para um câmbio

O KYC verifica quem é o seu utilizador no momento do registo. O KYT observa o que o dinheiro deles faz depois — especificamente, de onde veio a criptomoeda que depositam e para onde vai a criptomoeda que levantam. Para um câmbio ou on-ramp, a obrigação é concreta: não aceite fundos com exposição a sanções, mixers, darknet, ransomware ou fundos roubados, e não envie fundos para carteiras com as mesmas características. A análise de carteiras é o mecanismo que impõe isso transação a transação.

Por que é importante

Depósitos e levantamentos são as únicas duas portas que o valor usa, portanto são as únicas duas portas que o risco usa. Um depósito contaminado aceite é uma exposição à lavagem de dinheiro nos seus livros; um levantamento enviado para uma carteira sancionada é uma violação de sanções, independentemente da intenção. A expectativa regulamentar para as VASP é o monitorização contínua explícita das transações, e a expectativa prática é que detete isso antes da liquidação, e não numa revisão de fim de mês.

A razão pela qual as equipas historicamente sub-analisavam era o custo: as subscrições de análise de blockchain legadas precificavam a análise como um contrato empresarial. A 0,02 $ por análise com BYOK, essa restrição desapareceu — pode analisar cada depósito e cada levantamento e ainda assim ser 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 está a analisar.

Depósito (INBOUND) — analise 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" }
  }'

Levantamento (OUTBOUND) — analise 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 na banda do veredicto:

{
  "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, analise a transação confirmada por hash (payment_reference_id) para manter um registo de auditoria pós-transferência.

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

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

Um fluxo de referência

Pedido de depósito
   └─ POST /v3/transactions/ (INBOUND, wallet_address, screening)
        ├─ LOW / MEDIUM  → creditar o depósito
        ├─ HIGH          → reter; abrir alerta; analista revê
        └─ CRITICAL      → rejeitar; congelar; abrir alerta; considerar SAR

Pedido de levantamento
   └─ POST /v3/transactions/ (OUTBOUND, destination wallet_address, screening)
        ├─ LOW / MEDIUM  → libertar
        ├─ HIGH          → reter; analista revê
        └─ CRITICAL      → bloquear; abrir alerta

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

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

Casos de uso

Câmbios centralizados — analise cada depósito e levantamento; recuse automaticamente CRITICAL, coloque HIGH em fila, registe o resto.
Plataformas On/off-ramp — controle as conversões fiat↔cripto na carteira da contraparte antes de liquidar para os trilhos bancários.
Corretoras que adicionam cripto — reutilize uma integração de monitorização de transações existente; a análise de cripto é o mesmo endpoint.
Custodiantes — analise na entrada e re-analise no movimento, com o grafo de rede como prova de congelamento.
VASPs — combine KYT com troca de dados FATF Travel Rule no mesmo motor para risco de contraparte de ponta a ponta.

Como integrar com a Didit

Configure provedor + padrão. Em Consola → Transações → Definições, defina Crystal ou Merkle Science (BYOK ou gerido) e o comportamento de análise padrão.
Escreva as regras de política. Ative o pacote de regras de análise de cripto e defina bandas → ações para que a maioria das decisões sejam automáticas.
Analise em ambas as portas. Chame POST /v3/transactions/ para cada depósito (INBOUND) e levantamento (OUTBOUND) antes da liquidação.
Registe após a liquidação. Re-analise a transação confirmada por hash para a trilha de auditoria.
Trabalhe os casos excecionais. As análises HIGH/CRITICAL abrem alertas; investigue, escale para um caso e arquive SARs na mesma Consola.

Como tudo está na API unificada /v3/, o mesmo utilizador que deposita passa pela monitorização de transações, uma transação sinalizada pode pausar via AWAITING_USER e acionar um passo de remediação, e KYC, KYT e AML compõem uma única plataforma de identidade e fraude.

Perguntas frequentes

Onde exatamente devo analisar?

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

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

Não. A 0,02 $ por análise com BYOK — aproximadamente 10 vezes mais barato do que comprar análises diretamente — analisar cada depósito e levantamento é 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 análise de cripto para que LOW/MEDIUM passem automaticamente, HIGH seja encaminhado para um analista e CRITICAL seja recusado. Os analistas apenas lidam com os casos excecionais.

Isso também abrange a Travel Rule?

Sim. O mesmo motor de Monitorização de Transações suporta a FATF Travel Rule, então a troca de dados da contraparte e a análise de carteiras funcionam em conjunto.

Quais provedores posso usar?

Crystal e Merkle Science hoje (BYOK ou gerido); Chainalysis e Elliptic estarão disponíveis em breve a 0,02 $ BYOK.

Pronto para começar?

Leia a visão geral da Análise de Carteiras na documentação, veja como se encaixa na plataforma na página do produto Análise de Carteiras 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 análise de carteiras a 0,02 $ por análise com BYOK.