Rastreio de Carteiras: Pré-Transferência vs. Pós-Transferência

Existem dois momentos para rastrear uma transação de criptomoedas, e eles respondem a duas questões diferentes. Antes de o valor se mover, rastreia-se o endereço da carteira para decidir se a transação deve sequer acontecer. Depois de o valor assentar, rastreia-se o hash da transação para registar o que realmente se moveu e reavaliá-lo em relação às informações mais recentes. O primeiro é uma barreira; o segundo é um livro-razão.

A API de Rastreio de Carteiras da Didit suporta ambos. O rastreio pré-transferência recebe um endereço de carteira e devolve um veredito de risco antes de aceitar um depósito ou libertar um levantamento. O rastreio pós-transferência recebe um hash de transação e avalia uma transação confirmada após o facto. Ambos devolvem a mesma pontuação de risco de 0 a 100 com bandas BAIXA/MÉDIA/ALTA/CRÍTICA e uma discriminação da origem dos fundos, e ambos custam 0,02 € por rastreio.

Este guia explica a diferença e como integrar cada um num fluxo real.

Principais pontos

• Pré-transferência = endereço, antes de o valor se mover. Rastreie um endereço de carteira para barrar um depósito ou levantamento antes que aconteça.
• Pós-transferência = hash da transação, após liquidação. Rastreie uma transação confirmada (por payment_reference_id) para registo e revisão contínua.
• Mesma estrutura de veredito para ambos — uma pontuação de risco de 0 a 100, uma banda BAIXA/MÉDIA/ALTA/CRÍTICA e exposição por categoria de origem de fundos.
• Use ambos em conjunto na maioria dos fluxos: pré-transferência para decidir, pós-transferência para documentar e verificar novamente.
• Desencadeado por currency_kind: "crypto" mais uma direção (INBOUND / OUTBOUND); substitua por chamada com include_crypto_screening.
• 0,02 € por rastreio com BYOK (Crystal ou Merkle Science), independentemente do momento que usar.

O que cada um rastreia

O rastreio pré-transferência avalia um endereço de carteira. Ainda não sabe que algum valor se vai mover — está a perguntar: "se eu aceitar fundos de (ou enviar fundos para) este endereço, a que estou exposto?" A API traça o histórico de entrada e saída do endereço e devolve o seu risco. Este é o ponto de decisão: aprovar, reter para revisão ou recusar antes que algo se liquide.

O rastreio pós-transferência avalia uma transação específica pelo seu hash. O valor já se moveu; está a registar o risco do que aconteceu e a mantê-lo atualizado. Como as etiquetas na cadeia evoluem — um endereço pode ser adicionado a uma lista de sanções depois de ter transacionado com ele — o rastreio pós-transferência (e o re-rastreio periódico) mantém os seus registos precisos para auditoria e obrigações de monitorização contínua.

Porque é que importa

Escolher o momento errado cria lacunas reais. Rastreie apenas pós-transferência e já aceitou os fundos antes de saber que eram arriscados — está agora a reverter uma transação liquidada em vez de recusar uma pendente. Rastreie apenas pré-transferência e os seus registos ficam desatualizados: o veredito que capturou no momento do depósito não reflete informações que surgiram posteriormente, o que enfraquece qualquer trilho de auditoria e perde designações de sanções retroativas.

Os reguladores e as boas práticas apontam para a mesma resposta: barre à entrada com rastreio pré-transferência, e depois mantenha um registo preciso e verificável com rastreio pós-transferência. A execução de ambos é o motivo pelo qual o preço de 0,02 € por rastreio importa — a esse custo, rastrear duas vezes ainda é uma ordem de magnitude mais barato do que um único rastreio numa subscrição legada.

Detalhes técnicos

Ambos os modos correm na API unificada /v3/ dentro do Monitorização de Transações. A diferença é se passa um endereço de carteira ou uma referência de transação.

Pré-transferência — rastrear um endereço antes de aceitar um depósito:

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_61a0",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x4d2a...91bc",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "RECEIVER" }
  }'

Pós-transferência — rastrear uma transação liquidada pelo seu hash:

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_77f3",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "OUTBOUND",
    "payment_reference_id": "0xabc123...def",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "SENDER" }
  }'

Ambos devolvem a mesma estrutura de veredito:

{
  "wallet_screening": {
    "risk_score": 41,
    "risk_band": "MEDIUM",
    "exposure": [
      { "category": "HIGH_RISK_EXCHANGE", "type": "DIRECT", "share": 0.27 }
    ]
  }
}

O gatilho. O rastreio é ativado quando currency_kind é "crypto" e uma direction (INBOUND ou OUTBOUND) é definida. O padrão — se as transações de criptomoedas são rastreadas automaticamente — é configurado em Consola → Transações → Definições, e include_crypto_screening substitui-o por chamada.

O campo chave. Passe um wallet_address para pré-transferência; passe o hash da transação como payment_reference_id para pós-transferência.

Preço. 0,02 € por rastreio, em qualquer modo, com BYOK (Crystal ou Merkle Science).

Quando usar cada um

Cenário	Uso	Porquê
Aceitar um depósito	Pré-transferência (endereço)	Decidir antes de os fundos serem seus
Libertar um levantamento	Pré-transferência (endereço de destino)	Bloquear o envio para uma carteira arriscada
Registrar uma transferência liquidada	Pós-transferência (hash)	Trilho de auditoria preciso do que se moveu
Re-rastreio periódico	Pós-transferência (hash)	Detetar designações de sanções retroativas
Ambos barreira e registo	Ambos	Barreira à entrada, documentar depois

Casos de uso

• Bolsas de criptomoedas — pré-transferência em cada depósito e levantamento para barrar o fluxo; pós-transferência para manter um livro-razão completo e verificável.
• Plataformas de entrada/saída (on/off-ramps) — pré-transferência para bloquear conversões envolvendo carteiras de alto risco antes da liquidação.
• Custodiantes — pré-transferência na entrada, re-rastreio pós-transferência em ativos armazenados à medida que as etiquetas evoluem.
• Carteiras — pré-transferência para avisar um utilizador antes de enviar para um endereço sinalizado.
• VASPs — registos pós-transferência emparelhados com dados da Regra de Viagem para um trilho de conformidade defensável.

Como integrar com a Didit

1. Defina o padrão em Transações → Definições — escolha se as transações de criptomoedas são rastreadas automaticamente e qual chave de provedor usar.
2. Barreira à entrada. Antes de aceitar um depósito ou libertar um levantamento, POST /v3/transactions/ com o wallet_address e aja com base na banda.
3. Registar após liquidação. Assim que uma transação for confirmada, rastreie-a novamente com o hash como payment_reference_id.
4. Gerir alertas. Os rastreios ALTO/CRÍTICO abrem alertas no gestor de casos integrado para investigação e preenchimento de SAR.

Perguntas frequentes

Qual é a diferença prática entre o rastreio pré- e pós-transferência?

O rastreio pré-transferência rastreia um endereço de carteira antes de o valor se mover, para que possa recusar. O rastreio pós-transferência rastreia uma transação liquidada pelo seu hash, para que tenha um registo preciso e verificável.

Preciso de fazer ambos?

A maioria das equipas deve fazê-lo. O pré-transferência barra o fluxo; o pós-transferência mantém os registos atualizados — incluindo a deteção de endereços adicionados a listas de sanções depois de ter transacionado.

Como rastreio um hash de transação?

Passe o hash como payment_reference_id em POST /v3/transactions/ com currency_kind: "crypto" e uma direção.

Fazer ambos custa o dobro?

Sim — 0,02 € cada — mas a esse preço dois rastreios ainda são muito mais baratos do que um rastreio numa subscrição legada de análise de blockchain.

Posso ativar o rastreio apenas para algumas transações?

Sim. Defina um padrão em Consola → Transações → Definições e substitua por chamada com include_crypto_screening.

Pronto para começar?

Leia a visão geral do Rastreio de Carteiras na documentação, veja como se encaixa na plataforma na página do produto Rastreio de Carteiras, e verifique o preço por chamada na página de preços. Quando estiver pronto, comece gratuitamente — 500 verificações KYC gratuitas todos os meses, e rastreio de carteira por 0,02 € por rastreio.