Blog · 21 de maio de 2026

Análise de Carteira: Pré-Transferência vs. Pós-Transferência (PT-PT-1)

A análise pré-transferência avalia um endereço de carteira antes da movimentação de valor; a pós-transferência analisa uma transação liquidada pelo seu hash.

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

Existem dois momentos para analisar uma transação de cripto, e cada um responde a perguntas diferentes. Antes da movimentação de valor, analisa-se o endereço da carteira para decidir se a transação deve ser permitida. Após a liquidação do valor, analisa-se o hash da transação para registar o que realmente foi movimentado e reavaliá-lo com base nas informações mais recentes. O primeiro é um portão; o segundo é um registo.

A API de Análise de Carteira da Didit suporta ambos. A análise pré-transferência recebe um endereço de carteira e retorna um veredito de risco antes de aceitar um depósito ou liberar um levantamento. A análise pós-transferência recebe um hash de transação e avalia uma transação confirmada posteriormente. Ambas retornam a mesma pontuação de risco de 0 a 100 com bandas BAIXO/MÉDIO/ALTO/CRÍTICO e uma discriminação da origem dos fundos, e ambas custam 0,02 € por análise.

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

Principais conclusões

Pré-transferência = endereço, antes da movimentação de valor. Analise um endereço de carteira para autorizar um depósito ou levantamento antes que aconteça.
Pós-transferência = hash da transação, após a liquidação. Analise 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 BAIXO/MÉDIO/ALTO/CRÍTICO 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.
Ativado por currency_kind: "crypto" mais uma direção (INBOUND / OUTBOUND); substitua por chamada com include_crypto_screening.
0,02 € por análise com BYOK (Crystal ou Merkle Science), independentemente do momento que usar.

O que cada um analisa

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

A análise pós-transferência avalia uma transação específica pelo seu hash. O valor já foi movimentado; 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 — a análise pós-transferência (e a reanálise periódica) mantém os seus registos precisos para auditoria e obrigações de monitorização contínua.

Porque é importante

Escolher o momento errado cria lacunas reais. Se analisar apenas pós-transferência, já aceitou os fundos antes de saber que eram arriscados — agora está a reverter uma transação liquidada em vez de recusar uma pendente. Se analisar apenas pré-transferência, 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 rasto de auditoria e perde designações retroativas de sanções.

Reguladores e boas práticas apontam para a mesma resposta: proteja a entrada com a análise pré-transferência e, em seguida, mantenha um registo preciso e verificável com a análise pós-transferência. Usar ambos é o motivo pelo qual o preço de 0,02 € por análise é importante — a esse custo, analisar duas vezes ainda é uma ordem de magnitude mais barato do que uma única análise numa subscrição legada.

Detalhes técnicos

Ambos os modos funcionam 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 — analisar 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 — analisar 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 retornam 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. A análise é acionada quando currency_kind é "crypto" e uma direction (INBOUND ou OUTBOUND) é definida. O padrão — se as transações de cripto são analisadas automaticamente — é configurado em Console → Transactions → Settings, 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 análise, em qualquer modo, com BYOK (Crystal ou Merkle Science).

Quando usar cada um

Cenário	Usar	Porquê
Aceitar um depósito	Pré-transferência (endereço)	Decidir antes que os fundos sejam seus
Liberar um levantamento	Pré-transferência (endereço de destino)	Bloquear o envio para uma carteira de risco
Registrar uma transferência liquidada	Pós-transferência (hash)	Rasto de auditoria preciso do que foi movimentado
Reanálise periódica	Pós-transferência (hash)	Detetar designações de sanções retroativas
Ambos (autorização e registo)	Ambos	Autorizar na entrada, documentar depois

Casos de uso

Bolsas de cripto — pré-transferência em cada depósito e levantamento para autorizar o fluxo; pós-transferência para manter um registo completo e verificável.
Rampas 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, reanálise pós-transferência de 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 rasto de conformidade defensável.

Como integrar com a Didit

Defina o padrão em Transactions → Settings — escolha se as transações de cripto são analisadas automaticamente e qual chave de provedor usar.
Autorize na entrada. Antes de aceitar um depósito ou liberar um levantamento, POST /v3/transactions/ com o wallet_address e aja de acordo com a banda.
Registe após a liquidação. Assim que uma transação for confirmada, analise-a novamente com o hash como payment_reference_id.
Lidar com alertas. Análises de 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 a análise pré e pós-transferência?

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

Preciso de fazer ambas?

A maioria das equipas deveria. A pré-transferência autoriza o fluxo; a pós-transferência mantém os registos atualizados — incluindo a deteção de endereços adicionados a listas de sanções após a transação.

Como analiso 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 ambas custa o dobro?

Sim — 0,02 € cada — mas a esse preço, duas análises ainda são muito mais baratas do que uma única análise numa subscrição legada de análise de blockchain.

Posso ativar a análise apenas para algumas transações?

Sim. Defina um padrão em Console → Transactions → Settings e substitua por chamada com include_crypto_screening.

Pronto para começar?

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