Blog · 21 de maio de 2026

Pontuação de Risco de Transação em Tempo Real por R$0,10 (PT-BR)

Pontue cada transação em tempo real, receba um de quatro status — APROVADO, EM_REVISÃO, RECUSADO, AGUARDANDO_USUÁRIO — e aja antes que o dinheiro seja liquidado. Veja como funciona a pontuação de risco por R$0,10 por transação.

Por Didit21 de maio de 2026Atualizado 21 de mai. de 2026

Monitoramento em lote é monitoramento pós-fato. Execute suas regras durante a noite e você descobrirá que um pagamento era suspeito na manhã seguinte à sua liquidação — quando o dinheiro já se foi e a única coisa a fazer é registrar um relatório. A pontuação em tempo real inverte isso: você avalia a transação enquanto ela ainda está em andamento, recebe uma decisão em milissegundos e age antes da liquidação.

A API de Monitoramento de Transações da Didit pontua cada transação em linha. Você envia o pagamento, o motor o executa contra todas as regras ativas, anexa uma pontuação de risco e retorna um de quatro status — APROVADO, EM_REVISÃO, RECUSADO ou AGUARDANDO_USUÁRIO. Pagamentos de baixo risco passam silenciosamente; os arriscados são retidos, bloqueados ou redirecionados ao usuário. Funciona para moedas fiduciárias e cripto, e custa R$0,10 por transação, sem mínimos.

Este guia explica como a pontuação funciona, o que significam os quatro status e como agir sobre eles antes que o dinheiro se mova.

Principais pontos

Tomada de decisão em tempo real. Cada transação é pontuada em linha e retorna um status em milissegundos — para que você possa agir antes que o dinheiro seja liquidado.
Quatro status: APROVADO, EM_REVISÃO, RECUSADO, AGUARDANDO_USUÁRIO — um resultado claro e acionável para cada pagamento.
Uma pontuação de risco numérica acompanha o status, acumulada das regras que foram acionadas, para que você possa definir seus próprios limites.
As regras impulsionam a pontuação — a ação de cada regra pode adicionar à pontuação, mudar o status, marcar a transação ou listar uma parte.
Moeda fiduciária e cripto em um único motor, pontuados da mesma forma; cripto pode acionar automaticamente a triagem de carteira on-chain.
R$0,10 por transação, pagamento por chamada, sem mínimos. A triagem AML de uma parte sinalizada é cobrada separadamente a R$1,00.

O que a pontuação de risco em tempo real faz

Cada transação que você envia é avaliada contra o conjunto completo de regras ativas em cada pacote habilitado. Cada regra que corresponde contribui: pode adicionar a uma pontuação de risco cumulativa, mudar o status, adicionar tags ou notas para um analista, ou adicionar uma parte a uma lista. O resultado são duas coisas sobre as quais você age — uma pontuação numérica que resume o quão arriscada o motor considera a transação, e um status que diz o que fazer a respeito.

Como a avaliação acontece em linha, a decisão é retornada antes da liquidação. Um pagamento limpo é APROVADO e prossegue sem atrito. Um pagamento que cruza um limite suave entra EM_REVISÃO e abre um alerta. Um pagamento que aciona uma regra difícil — uma contraparte sancionada — é RECUSADO. E um pagamento que é arriscado, mas recuperável, entra em AGUARDANDO_USUÁRIO, pausando para uma etapa adicional que o usuário pode resolver.

Por que isso importa

O valor total do monitoramento está no tempo. Detectar estruturação ou uma contraparte sancionada com um dia de atraso significa que os fundos já saíram; tudo o que você pode fazer é relatar. Detectar no momento significa que você pode reter o pagamento, recusá-lo ou remediá-lo — você impede o dano em vez de documentá-lo.

A pontuação em tempo real também muda a economia. Sistemas em lote forçam uma escolha brusca entre bloquear demais e revisar tudo. Uma pontuação por transação com quatro status distintos permite que você calibre: aprove automaticamente a maioria limpa, revise o que é genuinamente ambíguo, recuse categoricamente o inequívoco e empurre os casos recuperáveis de volta para o usuário. O tempo do analista vai apenas para onde é necessário, e a R$0,10 por transação o custo acompanha o volume em vez de licenças por assento.

Detalhes técnicos

As transações são criadas contra a API unificada /v3/, idempotente em um transaction_id que você controla:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_e02b7c",
    "category": "finance",
    "amount": 15000,
    "currency": "EUR",
    "currency_kind": "fiat",
    "txn_date": "2026-05-21T15:22:00Z",
    "subject": { "vendor_data": "user_2204", "role": "SENDER", "entity_type": "INDIVIDUAL" },
    "counterparty": { "role": "RECEIVER", "entity_type": "INDIVIDUAL" },
    "payment_method": "BANK_TRANSFER"
  }'

A resposta contém a pontuação de risco, o status e as regras que contribuíram:

{
  "transaction_id": "txn_e02b7c",
  "status": "IN_REVIEW",
  "risk_score": 61,
  "triggered_rules": [
    { "name": "Large transaction", "bundle": "Finance", "action": "ADD_SCORE" },
    { "name": "New account — high value", "bundle": "AML/CTF", "action": "CHANGE_STATUS" }
  ],
  "alert_id": "alrt_3f90aa"
}

Os quatro status:

Status	Significado
`APPROVED`	Nenhuma regra ultrapassou um limite de recusa — a transação prossegue.
`IN_REVIEW`	Uma regra sinalizou a transação — um alerta é aberto para um analista.
`DECLINED`	Uma regra rígida (por exemplo, contraparte sancionada) bloqueou a transação.
`AWAITING_USER`	A transação está retida aguardando uma ação do usuário — reverificação ou prova de fundos.

Webhooks. Assine transaction.created e transaction.status.updated para que seu registro reflita a decisão e qualquer alteração posterior quando um analista resolver um alerta ou uma remediação for concluída.

Preço. R$0,10 por transação, cobrado por chamada, sem mínimos. A triagem AML de uma parte sinalizada é cobrada separadamente a R$1,00.

Agindo antes da liquidação

O objetivo da pontuação em linha é que o status chegue a tempo de fazer algo:

APROVADO — libere o pagamento. Sem atrito, sem analista.
EM_REVISÃO — retenha ou liquide e monitore conforme sua política; um alerta já está aberto para um analista investigar.
RECUSADO — bloqueie o pagamento imediatamente; a transação nunca é liquidada.
AGUARDANDO_USUÁRIO — pause e solicite ao usuário uma etapa adicional; a transação é retomada automaticamente assim que ele a conclui.

Você define os limites que mapeiam a pontuação numérica para suas próprias ações internas, além dos status que o motor retorna. Uma pontuação de 60 pode ser uma retenção para um produto e um liquidar-e-monitorar para outro — o motor fornece o número e o status; sua política decide a consequência.

Casos de uso

Fintech — pontue depósitos, transferências e saques em linha; retenha transferências de alto valor pela primeira vez para revisão antes da liquidação.
Cripto — pontue transações on-chain e acione a triagem de carteira na contraparte antes que uma transferência de saída seja efetuada.
Empréstimos — pontue desembolsos para sinais de identidade sintética e mula antes que os fundos sejam liberados.
Marketplaces — pontue pagamentos de vendedores para padrões de velocidade e abuso de reembolso antes que o dinheiro se mova.
iGaming — pontue depósitos para picos de velocidade que também servem como um sinal de jogo responsável.

Como integrar com a Didit

Configure regras e limites. No Business Console, ative os pacotes que se adequam ao seu negócio e defina os limites de pontuação que se mapeiam às suas ações.
Pontue em linha. POST /v3/transactions/ de forma síncrona do seu caminho de pagamento, com um transaction_id estável e vendor_data vinculando cada um ao seu usuário.
Aja de acordo com o status. Aprove, retenha, recuse ou solicite remediação com base no status e na pontuação retornados.
Sincronize com webhooks. Ouça transaction.status.updated para reagir quando um analista resolver um alerta ou uma etapa AGUARDANDO_USUÁRIO for concluída.

Como tudo está na API unificada /v3/, um usuário integrado com fluxos KYC vai direto para o mesmo motor que pontua suas transações — uma plataforma de identidade e fraude, de ponta a ponta.

Perguntas frequentes

Qual a velocidade da pontuação?

É em tempo real — a transação é pontuada em linha e retorna um status em milissegundos, para que você possa agir antes que o dinheiro seja liquidado.

O que a pontuação de risco representa?

Um resumo numérico de quão arriscada o motor julgou a transação, acumulada das regras que foram acionadas. Ela acompanha o status, para que você possa definir seus próprios limites além dos quatro resultados integrados.

Quais são os quatro status?

APROVADO, EM_REVISÃO, RECUSADO e AGUARDANDO_USUÁRIO. Aprovado prossegue, em revisão abre um alerta, recusado bloqueia o pagamento e aguardando o usuário pausa para uma etapa adicional que o usuário pode resolver.

Ele também pontua transações de cripto?

Sim. Defina currency_kind como fiat ou crypto. As transações de cripto são pontuadas da mesma forma e podem acionar automaticamente a triagem de carteira on-chain.

Qual o custo?

R$0,10 por transação, cobrado por chamada, sem mínimos. A triagem AML de uma parte sinalizada é cobrada separadamente a R$1,00.

Pronto para começar?

Leia a visão geral do Monitoramento de Transações na documentação, veja como ele se encaixa no restante da plataforma na página do produto Monitoramento de Transações e verifique os preços transparentes por chamada na página de preços. Quando estiver pronto, comece gratuitamente — 500 verificações KYC gratuitas todos os meses e monitoramento de transações a R$0,10 por chamada.