KYT para Exchanges de Cripto e On-Ramps: Um Guia de Implementação

Uma exchange de cripto ou on-ramp tem exatamente dois momentos em que o risco on-chain entra ou sai do negócio: um depósito chega e um levantamento sai. Se a triagem for feita corretamente nestes dois pontos, terá coberto o essencial do Know Your Transaction (KYT). Se for feita incorretamente — triagem demasiado tardia, triagem errada, 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 fazer 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/ a 0,02 € por análise com "bring-your-own-key" (BYOK).

Principais conclusões

• Dois pontos de triagem: analise o endereço de depósito na entrada, analise o endereço de destino na saída.
• Controle antes da liquidação. A triagem pré-transferência permite recusar um depósito ou bloquear um levantamento 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 — os analistas só lidam com os casos excecionais.
• Registos pós-transferência por "hash" de transação mantêm um rasto de auditoria e detetam designações de sanções retroativas.
• Gestão de casos + fluxo de trabalho SAR incorporados — os alertas abrem na mesma Consola, sem necessidade de uma ferramenta separada.
• 0,02 € por análise com BYOK (Crystal ou Merkle Science); pagamento por chamada, sem mínimos.

O que KYT significa para uma exchange

O KYC verifica a identidade do seu utilizador no momento da adesão. O KYT monitoriza o que o dinheiro faz depois — especificamente, de onde veio a cripto que depositam e para onde vai a cripto que levantam. Para uma exchange ou on-ramp, a obrigação é concreta: não aceitar fundos com exposição a sanções, "mixer", "darknet", "ransomware" ou fundos roubados, e não enviar 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, por isso são as únicas duas portas que o risco usa. Um depósito contaminado aceite é uma exposição de lavagem nos seus livros; um levantamento enviado para uma carteira sancionada é uma violação de sanções, independentemente da intenção. A expectativa regulatória para as VASP é uma monitorização contínua e explícita de 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 faziam menos triagem era o custo: as subscrições de análise de "blockchain" legadas precificavam a triagem 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 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 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 libertar:

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

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 de Análise de cripto para que o estado seja devolvido já decidido — o seu "backend" apenas age sobre ele.

Casos de uso

• Exchanges centralizadas — analise cada depósito e levantamento; recuse automaticamente CRITICAL, coloque HIGH em fila, registe o resto.
• On/off-ramps — controle as conversões fiat↔cripto na carteira da contraparte antes de liquidar para os sistemas bancários.
• Corretoras a adicionar 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 reanalise no movimento, com o gráfico de rede como evidência 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

1. Configurar fornecedor + padrão. Em Consola → Transações → Definições, defina Crystal ou Merkle Science (BYOK ou gerido) e o comportamento de análise padrão.
2. Escrever 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 seja automática.
3. Analisar em ambas as portas. Chame POST /v3/transactions/ para cada depósito (INBOUND) e levantamento (OUTBOUND) antes da liquidação.
4. Registar após a liquidação. Reanalise a transação confirmada por "hash" para o rasto de auditoria.
5. Trabalhar 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 ser pausada 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 devo exatamente 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 levantamento (OUTBOUND) antes de libertar. Adicione a triagem pós-transferência por "hash" para registos.

A triagem de cada transação não será cara?

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 só lidam com os casos excecionais.

Isto também abrange a "Travel Rule"?

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

Que fornecedores posso usar?

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

Pronto para começar?

Leia a visão geral de 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.