Blog · 21 de maio de 2026

Pontuação de Risco de Transação em Tempo Real a €0,02 por Transação (PT-PT)

Analise cada transação em tempo real e obtenha um de quatro estados — APROVADO, EM_REVISÃO, RECUSADO, AGUARDA_UTILIZADOR — para agir antes que o dinheiro seja liquidado.

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

A monitorização em lote é uma monitorização a posteriori. Se executar as suas regras durante a noite, descobrirá que um pagamento era suspeito na manhã seguinte à liquidação — quando o dinheiro já se foi e a única coisa a fazer é apresentar um relatório. A pontuação em tempo real inverte isso: avalia a transação enquanto esta ainda está em andamento, obtém uma decisão em milissegundos e age antes da liquidação.

A API de Monitorização de Transações da Didit pontua cada transação em linha. Envia o pagamento, o motor executa-o contra todas as regras ativas, anexa uma pontuação de risco e devolve um de quatro estados — APROVADO, EM_REVISÃO, RECUSADO ou AGUARDA_UTILIZADOR. Pagamentos de baixo risco passam silenciosamente; os arriscados são retidos, bloqueados ou redirecionados para o utilizador. Funciona para moedas fiduciárias e criptomoedas, e custa €0,02 por transação, sem mínimos.

Este guia explica como funciona a pontuação, o significado dos quatro estados e como agir sobre eles antes que o dinheiro se movimente.

Principais conclusões

Decisão em tempo real. Cada transação é pontuada em linha e retorna um estado em milissegundos — para que possa agir antes que o dinheiro seja liquidado.
Quatro estados: APROVADO, EM_REVISÃO, RECUSADO, AGUARDA_UTILIZADOR — um resultado claro e acionável para cada pagamento.
Uma pontuação de risco numérica acompanha o estado, acumulada das regras que foram acionadas, para que possa definir os seus próprios limites.
As regras impulsionam a pontuação — a ação de cada regra pode adicionar à pontuação, alterar o estado, etiquetar a transação ou listar uma parte.
Moeda fiduciária e cripto num único motor, pontuadas da mesma forma; cripto pode acionar automaticamente a verificação de carteiras on-chain.
€0,02 por transação, pagamento por chamada, sem mínimos. A triagem AML de uma parte sinalizada é faturada separadamente a €0,20.

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

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

Como a avaliação acontece em linha, a decisão chega 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 rigorosa — uma contraparte sancionada — é RECUSADO. E um pagamento que é arriscado, mas recuperável, entra em AGUARDA_UTILIZADOR, pausando para um passo adicional que o utilizador pode resolver.

Por que é importante

Todo o valor da monitorização está no timing. Detetar estruturação ou uma contraparte sancionada um dia depois significa que os fundos já saíram; tudo o que pode fazer é reportar. Detetar no momento significa que pode reter o pagamento, recusá-lo ou remediá-lo — impede o dano em vez de o documentar.

A pontuação em tempo real também muda a economia. Os sistemas em lote forçam uma escolha difícil entre bloquear demasiado e rever tudo. Uma pontuação por transação com quatro estados distintos permite-lhe calibrar: aprovar automaticamente a maioria limpa, rever os casos genuinamente ambíguos, recusar categoricamente os inequívocos e devolver os casos recuperáveis ao utilizador. O tempo do analista é usado apenas onde é necessário, e a €0,02 por transação, o custo acompanha o volume em vez das licenças de lugares.

Detalhes técnicos

As transações são criadas contra a API unificada /v3/, idempotente num transaction_id que 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 estado 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 estados:

Estado	Significado
`APROVADO`	Nenhuma regra cruzou um limite de recusa — a transação prossegue.
`EM_REVISÃO`	Uma regra sinalizou a transação — um alerta é aberto para um analista.
`RECUSADO`	Uma regra estrita (ex: contraparte sancionada) bloqueou a transação.
`AGUARDA_UTILIZADOR`	A transação é retida aguardando uma ação do utilizador — reverificação ou prova de fundos.

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

Preço. €0,02 por transação, faturado por chamada, sem mínimos. A triagem AML de uma parte sinalizada é faturada separadamente a €0,20.

Agir antes da liquidação

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

APROVADO — libere o pagamento. Sem atrito, sem analista.
EM_REVISÃO — retenha ou liquide e observe de acordo com a sua política; um alerta já está aberto para um analista investigar.
RECUSADO — bloqueie o pagamento logo; a transação nunca se liquida.
AGUARDA_UTILIZADOR — pause e solicite ao utilizador um passo adicional; a transação é retomada automaticamente assim que for concluída.

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

Casos de uso

Fintech — pontue depósitos, transferências e levantamentos 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 verificação de carteira na morada da contraparte antes de uma transferência de saída ser efetuada.
Empréstimos — pontue desembolsos para sinais de identidade sintética e mula antes da libertação dos fundos.
Marketplaces — pontue pagamentos de vendedores para padrões de velocidade e abuso de reembolso antes que o dinheiro se movimente.
iGaming — pontue depósitos para picos de velocidade que funcionam como um sinal de jogo responsável.

Como integrar com a Didit

Configurar regras e limites. Na Consola de Negócios, ative os pacotes que se adequam ao seu negócio e defina os limites de pontuação que correspondem às suas ações.
Pontuar em linha. POST /v3/transactions/ de forma síncrona a partir do seu caminho de pagamento, com um transaction_id estável e vendor_data a ligar cada um ao seu utilizador.
Agir sobre o estado. Aprovar, reter, recusar ou solicitar remediação com base no estado e pontuação retornados.
Sincronizar com webhooks. Ouça transaction.status.updated para reagir quando um analista resolver um alerta ou um passo AGUARDA_UTILIZADOR for concluído.

Como tudo está na API unificada /v3/, um utilizador integrado com fluxos KYC entra diretamente no mesmo motor que pontua as suas transações — uma plataforma de identidade e fraude, de ponta a ponta.

Perguntas frequentes

Qual a rapidez da pontuação?

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

O que representa a pontuação de risco?

Um resumo numérico do quão arriscada o motor considerou a transação, acumulada das regras que foram acionadas. Acompanha o estado, para que possa definir os seus próprios limites além dos quatro resultados incorporados.

Quais são os quatro estados?

APROVADO, EM_REVISÃO, RECUSADO e AGUARDA_UTILIZADOR. Aprovado prossegue, em revisão abre um alerta, recusado bloqueia o pagamento e aguarda utilizador pausa para um passo adicional que o utilizador pode resolver.

Pontua transações cripto também?

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

Qual o custo?

€0,02 por transação, faturado por chamada, sem mínimos. A triagem AML de uma parte sinalizada é faturada separadamente a €0,20.

Pronto para começar?

Leia a visão geral da Monitorização de Transações na documentação, veja como se encaixa no resto da plataforma na página do produto Monitorização de Transações e verifique o preço transparente por chamada na página de preços. Quando estiver pronto, comece gratuitamente — 500 verificações KYC gratuitas todos os meses e monitorização de transações a €0,02 por chamada.