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

Existem dois momentos para analisar uma transação de cripto, e eles respondem a duas perguntas diferentes. Antes da movimentação de valor, você analisa o endereço da carteira para decidir se permite que a transação aconteça. Após a liquidação do valor, você analisa o hash da transação para registrar o que realmente foi movimentado e reavaliá-lo com base nas informações mais recentes. O primeiro é uma barreira; o segundo é um registro.

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 que você aceite um depósito ou libere uma retirada. A análise pós-transferência recebe um hash de transação e avalia uma transação confirmada após o fato. Ambas retornam a mesma pontuação de risco de 0 a 100 com faixas BAIXA/MÉDIA/ALTA/CRÍTICA e um detalhamento da origem dos fundos, e ambas custam US$ 0,02 por análise.

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

Principais pontos

• Pré-transferência = endereço, antes da movimentação de valor. Analise um endereço de carteira para barrar um depósito ou retirada 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 fins de registro e revisão contínua.
• Mesmo formato de veredito para ambos — uma pontuação de risco de 0 a 100, uma faixa BAIXA/MÉDIA/ALTA/CRÍTICA e exposição por categoria de origem dos fundos.
• Use ambos juntos na maioria dos fluxos: pré-transferência para decidir, pós-transferência para documentar e verificar novamente.
• Acionado por currency_kind: "crypto" mais uma direção (INBOUND / OUTBOUND); sobrescreva por chamada com include_crypto_screening.
• US$ 0,02 por análise com BYOK (Crystal ou Merkle Science), independentemente do tempo de uso.

O que cada um analisa

A análise pré-transferência avalia um endereço de carteira. Você ainda não sabe se algum valor será movimentado — você está perguntando: "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 seu risco. Este é o ponto de decisão: aprovar, reter para revisão ou recusar antes que algo seja liquidado.

A análise pós-transferência avalia uma transação específica pelo seu hash. O valor já foi movimentado; você está registrando o risco do que aconteceu e mantendo-o atualizado. Como os rótulos on-chain evoluem — um endereço pode ser adicionado a uma lista de sanções depois que você transacionou com ele — a análise pós-transferência (e a reanálise periódica) mantém seus registros precisos para auditoria e obrigações de monitoramento contínuo.

Por que isso importa

Escolher o momento errado cria lacunas reais. Analisar apenas pós-transferência significa que você já aceitou os fundos antes de saber que eram arriscados — agora você está desfazendo uma transação liquidada em vez de recusar uma pendente. Analisar apenas pré-transferência faz com que seus registros se tornem desatualizados: o veredito que você capturou no momento do depósito não reflete informações que surgiram depois, o que enfraquece qualquer trilha de auditoria e perde designações de sanções retroativas.

Reguladores e boas práticas apontam para a mesma resposta: barre na frente com a análise pré-transferência, depois mantenha um registro preciso e verificável com a análise pós-transferência. Usar ambos é o motivo pelo qual o preço de US$ 0,02 por análise importa — a esse custo, analisar duas vezes ainda é uma ordem de magnitude mais barato do que uma única análise em uma assinatura legada.

Detalhes técnicos

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

Pré-transferência — analise 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 — analise 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 → Transações → Configurações, e include_crypto_screening o sobrescreve 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. US$ 0,02 por análise, em qualquer modo, com BYOK (Crystal ou Merkle Science).

Quando usar cada um

Cenário	Uso	Por quê
Aceitando um depósito	Pré-transferência (endereço)	Decida antes que os fundos sejam seus
Liberando uma retirada	Pré-transferência (endereço de destino)	Bloqueie o envio para uma carteira de risco
Registrando uma transferência liquidada	Pós-transferência (hash)	Trilha de auditoria precisa do que foi movimentado
Reanálise periódica	Pós-transferência (hash)	Detectar designações de sanções retroativas
Ambos bloqueio e manutenção de registros	Ambos	Bloqueie na frente, documente depois

Casos de uso

• Corretoras de cripto — pré-transferência em cada depósito e retirada para controlar o fluxo; pós-transferência para manter um registro 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 em ativos armazenados à medida que os rótulos evoluem.
• Carteiras — pré-transferência para alertar um usuário antes que ele envie para um endereço sinalizado.
• VASPs — registros pós-transferência pareados com dados da Travel Rule para uma trilha de conformidade defensável.

Como integrar com a Didit

1. Defina o padrão em Transações → Configurações — escolha se as transações de cripto são analisadas automaticamente e qual chave de provedor usar.
2. Barre na frente. Antes de aceitar um depósito ou liberar uma retirada, POST /v3/transactions/ com o wallet_address e aja de acordo com a faixa de risco.
3. Registre após a liquidação. Assim que uma transação for confirmada, analise-a novamente com o hash como payment_reference_id.
4. Lide com alertas. Análises BAIXAS/CRÍTICAS abrem alertas no gerenciador de casos integrado para investigação e registro 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 você possa recusar. A pós-transferência analisa uma transação liquidada pelo seu hash, para que você tenha um registro preciso e verificável.

Preciso fazer os dois?

A maioria das equipes deveria. A pré-transferência controla o fluxo; a pós-transferência mantém os registros atualizados — incluindo a detecçã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.

Executar ambos custa o dobro?

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

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

Sim. Defina um padrão em Console → Transações → Configurações e sobrescreva 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 ela 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 US$ 0,02 por análise.