> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Biblioteca de regras KYT: mais de 150 cenários predefinidos

> Didit: 150+ regras KYT predefinidas para estruturação, velocidade, sanções, cripto e iGaming. 1,000 por mês incluídas, depois $0.001 cada.

Didit disponibiliza uma biblioteca selecionada de **mais de 150 regras predefinidas de monitorização de transações**, que pode instalar individualmente ou por pacote. Cada regra corresponde a uma tipologia real de AML, fraude ou conformidade, extraída de normas e orientações regulamentares globais: recomendações do GAFI (FATF), avisos da FinCEN, regras da NACHA, princípios de Wolfsberg, tipologias do Grupo Egmont e padrões de abuso em iGaming.

Escolha as predefinições ou os pacotes de que precisa e, em seguida, controle o modo de cada regra instalada (`ACTIVE`, `TEST` ou `DISABLED`). As condições, os limiares e as ações das predefinições são fixos; crie uma regra personalizada quando precisar de uma lógica diferente. Desinstale uma predefinição para a remover da aplicação e reinstale-a mais tarde, se necessário.

> [!NOTE]
>
> As regras da biblioteca podem ser consultadas, instaladas e desinstaladas em *Transactions -> Rules -> Library* na Business Console, através da [API da biblioteca de regras](https://docs.didit.me/pt/management-api/transactions/rules-library.md) (`GET /v3/transactions/rules/library/`, `POST`/`DELETE /v3/transactions/rules/install/`), ou através das [ferramentas MCP](https://docs.didit.me/pt/integration/mcp/tools.md) `didit_transaction_rule_library_list` / `didit_transaction_rule_install` / `didit_transaction_rule_uninstall`. As predefinições instaladas aceitam apenas alterações de `mode` (ativar, desativar, testar); os respetivos limiares são fixos: para os substituir, crie uma [regra personalizada](https://docs.didit.me/pt/transaction-monitoring/rules.md#criar-regras-personalizadas). Para saber como as regras contribuem para a pontuação, consulte a [pontuação de risco](https://docs.didit.me/pt/transaction-monitoring/risk-scoring.md).

> [!NOTE]
>
> Uma regra da biblioteca cujas condições leem dados que o motor de regras ainda não consegue avaliar fica **retida** até poder ser executada: a biblioteca não a apresenta na lista, um pedido que a indique em `library_keys` responde com `400` e não instala nada (uma chave desconhecida é ignorada), e uma instalação por `bundle` a ignora. Uma cópia que tenha instalado anteriormente é desligada (`DISABLED`) e mantém-se na sua lista de regras, e definir o respetivo `mode` para outro valor responde com `400`. Uma regra retida volta automaticamente quando o motor de regras puder avaliar as suas condições, pelo que a lista da biblioteca mostra sempre as regras que pode instalar hoje.

## Como as predefinições estão organizadas

Cada predefinição pertence a um **pacote** (a sua família funcional) e a uma **categoria** (o tema de risco mais amplo). Os pacotes permitem ativar ou desativar regras relacionadas em conjunto a partir da consola; as categorias orientam a pontuação e os relatórios.

| Pacote | O que abrange |
| - | - |
| `finance` | Estruturação, transações de valor elevado, volume acumulado, dispersão por países, layering, fan-in de contas de mulas, smurfing |
| `aml_ctf` | Sanções, referências de pagamento suspeitas, layering com montantes redondos, entradas e saídas rápidas |
| `aml_monitoring` | Exposição a origens de fundos de alto risco derivadas da blockchain, financiamento do terrorismo, exploração infantil |
| `anomaly_detection` | Velocidade elevada, reativação de contas inativas, atividade fora do horário |
| `fatf` | Exposição a jurisdições de alto risco |
| `device_intelligence` | Reutilização de impressões digitais de dispositivo, contas com várias impressões digitais, anomalias de IP/navegador, VPN/proxy, deslocação impossível |
| `fraud_prevention_multi_accounting` | Impressões digitais partilhadas entre sujeitos distintos |
| `fraud_prevention_app` | Sinais de pagamento autorizado por push / beneficiário pela primeira vez / vítima de fraude |
| `fraud_prevention_ato` | Sinais compostos de apropriação de conta (alteração de dados pessoais, novo método de pagamento) |
| `fraud_prevention_consortium` | Contrapartes sinalizadas por outras instituições na rede partilhada |
| `crypto_monitoring` | Exposição a carteiras de mixers, darknet ou sancionadas, chain hopping, carteiras autocustodiadas, lacunas nos VASP |
| `travel_rule` | Obrigações globais e regionais da Travel Rule (12 regimes) e diligência devida sobre o VASP da contraparte |
| `travel_rule_eu_tfr` | Verificações do TFR da UE: incompatibilidade de dados da contraparte, propriedade da carteira não verificada, VASP da contraparte não identificado, confirmação expirada |
| `responsible_gaming` | Limites de depósito e levantamento para jogo responsável, autoexclusão, jogo fora do horário |
| `igaming_fraud` | Abuso de bónus nativo de eventos, apostas opostas, fraude de afiliados, exploração de chuvas no chat, chip dumping, apropriação de conta |
| `e_commerce` | Testes de cartão com microtransações, indicadores de contestação, incompatibilidade do país de faturação, pico repentino de atividade de afiliados |
| `check_fraud` | Cheques fora do intervalo, sem número, apresentados em duplicado, presentes na lista de vigilância da dark web, branqueados, kiting |
| `bnpl` | Fraude de primeira parte por incumprimento de pagamentos, identificadores partilhados entre contas BNPL, prestações em contas recém-criadas |

## Como ler esta página

Cada regra indica o seu `library_key` (identificador estável ao qual pode fazer referência na API ou no URL da consola), as condições e a agregação que a fazem disparar, e as ações predefinidas que executa. Os limiares numéricos apresentados aqui são os valores predefinidos de fábrica: cada valor pode ser editado por aplicação sem perder a identidade da regra.

***

## Conjunto de finanças

Estas regras aplicam-se a todas as transações com `transaction_type = FINANCE`. Modelam a base regulamentar (limiares de comunicação BSA/FinCEN e heurísticas de velocidade do GAFI), bem como padrões de mulas de dinheiro e smurfing.

### Estruturação e proximidade do limiar

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `structuring-inbound` | ≥20 transferências de entrada inferiores a \$10,000 pelo mesmo sujeito em 30 dias | +35 pontos |
| `structuring-outbound` | ≥20 transferências de saída inferiores a \$10,000 pelo mesmo sujeito em 30 dias | +35 pontos |
| `single-transaction-just-below-threshold` | Uma única transação entre $9,000 e $9,999 | +25 pontos |
| `round-amount-layering` | O montante da transferência é um valor suspeitosamente redondo ($10k, $25k, $50k, $100k, $250k, $500k, \$1M…) | +20 pontos |

### Volume e velocidade

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `large-single-transaction` | Uma única transação ≥ \$25,000 | +50 pontos, `IN_REVIEW` |
| `cumulative-outbound-volume` | Volume de saída ≥ \$100,000 em 30 dias | +45 pontos, `IN_REVIEW` |
| `cumulative-inbound-volume-90d` | Volume de entrada ≥ \$200,000 em 90 dias | +30 pontos, `IN_REVIEW` |
| `cumulative-outbound-volume-7d` | Volume de saída ≥ \$50,000 em 7 dias | +30 pontos, `IN_REVIEW` |
| `business-4h-inbound-volume` | Volume de entrada de empresas ≥ \$30,000 em qualquer janela de 4 horas | +30 pontos, `IN_REVIEW` |
| `business-4h-outbound-volume` | Volume de saída de empresas ≥ \$30,000 em qualquer janela de 4 horas | +30 pontos, `IN_REVIEW` |
| `high-velocity-inbound` | ≥20 transações de entrada em 7 dias | +25 pontos |
| `high-velocity-outbound` | ≥20 transações de saída em 7 dias | +25 pontos |

### Stratificação, mulas e smurfing

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `rapid-in-and-out-movement` | Uma transferência de saída precedida de uma transferência de entrada no prazo de 6 horas | +60 pontos, `IN_REVIEW` |
| `cash-deposit-followed-by-withdrawal` | Depósitos em numerário ≥ \$50,000 em 72 h seguidos de um levantamento em numerário | +30 pontos, `IN_REVIEW` |
| `money-mule-fan-in-to-counterparty` | Uma contraparte recebe transferências de ≥5 sujeitos distintos em 7 dias | +30 pontos, `IN_REVIEW` |
| `rapid-repeated-payments-same-counterparty` | ≥5 transferências de saída para a mesma contraparte em 24 horas | +30 pontos, `IN_REVIEW` |
| `cross-border-small-amount-velocity` | Um sujeito envia montantes inferiores a \$1,000 para ≥4 países distintos das contrapartes em 24 h | +30 pontos, `IN_REVIEW` |
| `high-risk-jurisdiction-smurfing` | ≥5 transferências de saída inferiores a \$1,000 para o mesmo país de alto risco em 7 dias | +30 pontos, `IN_REVIEW` |
| `many-unique-counterparties-24h` | O sujeito transaciona com ≥6 contrapartes distintas em 24 horas | +30 pontos, `IN_REVIEW` |
| `many-unique-payment-methods-7d` | O sujeito alterna entre ≥4 métodos de pagamento distintos em 7 dias | +30 pontos, `IN_REVIEW` |
| `counterparty-country-spread-24h` | O sujeito transaciona com ≥4 países distintos das contrapartes em 24 horas | +30 pontos, `IN_REVIEW` |

### Anomalias comportamentais

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `dormant-account-reactivation` | Primeira transação ≥ \$1,000 após ≥365 dias de inatividade | +20 pontos |
| `off-hours-high-value-finance` | Transferência de valor elevado (≥ \$5,000) assinalada como fora do horário habitual para a localidade do sujeito | +25 pontos |

***

## Conjunto AML / CTF

Estas regras modelam tipologias clássicas de AML/CTF que não dependem do enriquecimento de blockchain. Aplicam-se universalmente a transferências em moeda fiduciária e em criptoativos.

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `sanctions-counterparty` | A carteira analisada é ela própria atribuída a uma entidade sancionada (`wallet_sanctioned`). A exposição, por si só, não a aciona | +90 pontos, `DECLINED` |
| `sanctions-exposure-review` | A carteira analisada movimentou fundos de entidades sancionadas ou para essas entidades, sem ser ela própria sancionada | +50 pontos, `IN_REVIEW` |
| `suspicious-payment-reference` | A referência do pagamento contém palavras-chave associadas a receitas de atividades ilícitas | +45 pontos, `IN_REVIEW` |
| `high-risk-jurisdiction-exposure` | O país da contraparte ou o país do IP do sujeito consta da lista de alto risco | +40 pontos, `IN_REVIEW` |
| `high-risk-inbound-single` | Entrada ≥ \$20,000 proveniente de um país de alto risco | +30 pontos, `IN_REVIEW` |
| `high-risk-outbound-single` | Saída ≥ \$20,000 para um país de alto risco | +30 pontos, `IN_REVIEW` |

A lista predefinida de jurisdições de alto risco inclui os territórios objeto de chamada à ação do GAFI e os territórios de regiões de conflito: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`. Pode substituir a lista por aplicação.

> [!NOTE]
>
> **A cobertura de contrapartes PEP não está disponível de momento.** Nenhum fornecedor de triagem ligado comunica se uma contraparte é uma pessoa politicamente exposta: o campo `pep_counterparty` é `null` em todos os resultados de triagem atuais (ver [triagem de carteiras](https://docs.didit.me/pt/transaction-monitoring/wallet-screening.md#resposta)), pelo que a biblioteca não tem uma predefinição de contraparte PEP. Uma regra instalada antes de essa predefinição ser retirada continua a ser avaliada, mas não consegue corresponder a uma triagem real. Remova-a ou substitua-a por uma regra personalizada se precisar de atuar sobre outro sinal.

***

## Conjunto de triagem cripto

Estas regras utilizam os dados enriquecidos produzidos pela triagem cripto da Didit. São mais úteis para aplicações nativas de cripto e para VASP.

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `aml-high-risk-source-exposure` | ≥30% dos fundos de origem provêm de categorias associadas a entidades sancionadas, à darknet, a roubo, a ransomware ou a fraude | +70 pontos, `IN_REVIEW` |
| `aml-multiple-risky-counterparties` | ≥3 ligações a entidades de alto risco no grafo da origem dos fundos | +50 pontos, `IN_REVIEW` |
| `aml-terrorist-financing-exposure` | Qualquer exposição a financiamento do terrorismo na carteira | +100 pontos, `DECLINED` |
| `aml-child-exploitation-exposure` | Qualquer exposição a material de exploração infantil na carteira | +100 pontos, `DECLINED` |
| `aml-wallet-risk-score-medium` | Pontuação de risco da carteira atribuída pelo fornecedor entre 40 e 70 | +30 pontos |

***

## Pacote de monitorização de criptoativos

Regras de exposição ao nível da carteira, além de verificações de integridade associadas a VASP e à Travel Rule.

| `library_key` | Gatilho | Ação predefinida |
| - | - | - |
| `crypto-mixer-exposure` | Carteira associada a um mixer ou serviço de ofuscação | +80 na pontuação, `IN_REVIEW` |
| `crypto-darknet_market-exposure` | Exposição de carteira associada a um mercado darknet | +80 na pontuação, `IN_REVIEW` |
| `crypto-sanctioned-exposure` | Exposição de carteira sancionada | +90 na pontuação, `IN_REVIEW` |
| `crypto-stolen_funds-exposure` | Exposição de carteira com fundos furtados | +85 na pontuação, `IN_REVIEW` |
| `crypto-scam-exposure` | Exposição de carteira associada a burla | +70 na pontuação, `IN_REVIEW` |
| `crypto-ransomware-exposure` | Exposição de carteira de ransomware | +90 na pontuação, `IN_REVIEW` |
| `crypto-hacked_exchange-exposure` | Exposição de carteira a plataforma de câmbio comprometida | +80 na pontuação, `IN_REVIEW` |
| `crypto-gambling_unlicensed-exposure` | Exposição de carteira a jogo de azar sem licença | +60 na pontuação, `IN_REVIEW` |
| `high-risk-wallet-exposure` | A carteira apresenta risco de mercado darknet, sanções ou fundos furtados | +70 na pontuação, `IN_REVIEW` |
| `crypto-wallet-risk-score-critical` | Pontuação de risco da carteira do fornecedor ≥ 90 | +90 na pontuação, `IN_REVIEW` |
| `crypto-wallet-risk-score-high` | Pontuação de risco da carteira do fornecedor ≥ 70 | +60 na pontuação, `IN_REVIEW` |
| `crypto-unhosted-wallet-large-outbound` | Transferências de saída ≥ \$1,000 para uma carteira autocustodiada | +45 na pontuação, `IN_REVIEW` |
| `crypto-repeated-unhosted-wallet-withdrawals` | ≥5 transferências de saída para carteiras autocustodiadas em 24 h | +35 na pontuação, `IN_REVIEW` |
| `crypto-many-new-wallets-per-subject` | O sujeito envia para ≥5 carteiras distintas em 24 h | +40 na pontuação, `IN_REVIEW` |
| `crypto-chain-hopping-pattern` | O mesmo sujeito movimenta fundos entre ≥3 blockchains em 24 h | +45 na pontuação, `IN_REVIEW` |
| `crypto-missing-vasp-id-high-value` | Transferência de saída a partir de uma carteira alojada ≥ \$1,000 sem identificador de VASP | +30 na pontuação, `IN_REVIEW` |

***

## Pacote Travel Rule

As regras Travel Rule aplicam-se apenas a transações `travelRule`.
Cada regime regional inclui quatro regras (contraparte pendente, ação pendente, dados obrigatórios em falta, falha na troca).

### Travel Rule global

| `library_key` | Gatilho | Ação predefinida |
| - | - | - |
| `travel-rule-pending-counterparty` | O estado é `AWAITING_COUNTERPARTY` (a aguardar o VASP da contraparte) | +35 na pontuação, `IN_REVIEW` |
| `travel-rule-pending-action` | O estado é `ON_HOLD` (numa plataforma de câmbio gerida, uma transferência recebida a aguardar que a resolva: sem correspondência no livro de endereços de carteiras, ou uma consulta a aguardar aprovação manual) | +35 na pontuação, `AWAITING_USER` |
| `travel-rule-missing-required-data` | `travel_rule_required` é `true` e `travel_rule_obligations_count` é superior a `0`; apenas os dados Travel Rule que regista em `travel_rule_details` têm uma contagem de obrigações, pelo que esta regra nunca é acionada numa transferência executada pela plataforma de câmbio gerida | +50 na pontuação, `IN_REVIEW` |

### Regimes regionais

O mesmo modelo de quatro regras aplica-se a cada regime. Substitua `<regime>` abaixo por qualquer um dos seguintes: `australia`, `dubai`, `eu`, `hong_kong`, `india`, `indonesia`, `japan`, `kazakhstan`, `singapore`, `south_africa`, `turkey`, `uk`.

A marcação do regime é automática: a Didit atribui `custom_values.travel_rule_regime` a cada transação Travel Rule a partir do campo `jurisdiction` das suas [definições Travel Rule](https://docs.didit.me/pt/transaction-monitoring/travel-rule.md#configuração) - `SG` → `singapore`, `GB` → `uk`, e qualquer código de Estado-Membro da UE ou do EEE, como `DE` ou `FR` → `eu`. Os códigos sem pacote regional são atribuídos em minúsculas (`US` → `us`), para que as regras personalizadas os possam ainda assim visar. Um valor de `props.travel_rule_regime` enviado na transação substitui sempre o regime derivado.

| Modelo de `library_key` | Gatilho |
| - | - |
| `travel-rule-<regime>-pending-counterparty` | Transferência com regime atribuído a aguardar o VASP da contraparte |
| `travel-rule-<regime>-pending-action` | A transferência com regime atribuído está `ON_HOLD` |
| `travel-rule-<regime>-missing-required-data` | A transferência com regime atribuído é obrigatória mas não está resolvida |
| `travel-rule-<regime>-failed-exchange` | A transferência com regime atribuído está `CANCELLED` |

Ou seja, são 48 regras específicas por região, além das três regras Travel Rule globais e das cinco regras de contraparte abaixo.
O pacote `travel_rule_eu_tfr`, separado, acrescenta quatro regras TFR da UE, descritas em [Pacote de regras TFR da UE](https://docs.didit.me/pt/transaction-monitoring/travel-rule.md#pacote-de-regras-tfr-da-ue).

### Diligência devida sobre contrapartes

Estas regras leem o que a sua aplicação sabe sobre o VASP da contraparte com que a plataforma de câmbio contactou: a sua própria decisão sobre ele, o nível de risco apurado na diligência devida, o país e a capacidade de resposta.
Consulte [Diligência devida sobre contrapartes](https://docs.didit.me/pt/transaction-monitoring/travel-rule.md#diligência-devida-da-contraparte) para saber de onde provém cada valor.

| `library_key` | Gatilho | Ação predefinida |
| - | - | - |
| `travel-rule-counterparty-blocked` | A sua decisão sobre a contraparte (`counterparty_dd_status`) é `BLOCKED` | +90 na pontuação, `DECLINED` |
| `travel-rule-counterparty-restricted` | A sua decisão sobre a contraparte é `RESTRICTED` | +50 na pontuação, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk` | O nível de risco da contraparte (`counterparty_risk_level`) é `HIGH`: uma pontuação de diligência devida inferior a 40, ou a sua própria triagem recente da contraparte detetou uma possível correspondência com sanções ou notícias adversas | +40 na pontuação, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk-jurisdiction` | A contraparte está estabelecida num país da lista predefinida de alto risco (`IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`) | +60 na pontuação, `IN_REVIEW` |
| `travel-rule-counterparty-unresponsive` | A contraparte respondeu a menos de 10 por cento dos pedidos Travel Rule que os clientes da Didit lhe enviaram nos últimos 90 dias, tendo sido tomada uma decisão sobre pelo menos 5 deles | +30 na pontuação, `IN_REVIEW` |

***

## Inteligência de dispositivo e prevenção de fraude

Estas regras transformam sinais do SDK do cliente (impressão digital do dispositivo, IP, navegador, idade da sessão) e do enriquecimento do fornecedor em eventos de deteção de fraude.

### Impressão digital do dispositivo e utilização de múltiplas contas

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `multi-accounting-shared-fingerprint` | Uma impressão digital do dispositivo reutilizada em ≥3 titulares distintos em 7 dias | +50 de pontuação, `IN_REVIEW` |
| `multiple-device-fingerprints-for-same-subject` | Um titular aparece em ≥3 impressões digitais distintas em 24 h | +20 de pontuação |
| `same-fingerprint-transaction-burst` | ≥6 transações a partir de uma impressão digital em 24 h | +30 de pontuação |
| `same-ip-multi-accounting` | Um IP partilhado por ≥3 titulares distintos em 7 dias | +30 de pontuação |
| `same-ip-transaction-burst` | ≥6 transações a partir de um IP em 24 h | +30 de pontuação |
| `same-fingerprint-multiple-payment-methods` | Uma impressão digital a alternar entre ≥4 métodos de pagamento em 7 dias | +30 de pontuação |
| `shared-payment-method-across-subjects` | Um método de pagamento reutilizado por ≥3 titulares distintos em 7 dias | +30 de pontuação |
| `many-ip-addresses-per-subject` | O titular utiliza ≥4 IP distintos em 24 h | +30 de pontuação |
| `new-browser-and-new-ip-combination` | O titular apresenta ≥3 navegadores distintos E ≥3 IP distintos em 24 h | +30 de pontuação |

### IP, rede e VPN

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `vpn-or-proxy-high-value` | VPN ou proxy detetado numa transferência ≥ \$5,000 | +30 de pontuação |
| `impossible-travel-between-transactions` | O titular transaciona a partir de ≥2 países distintos associados a endereços IP, no espaço de 1 hora | +30 de pontuação |

### Composto comportamental

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `browser-spoofing-password-reuse` | Spoofing de navegador detetado E ≥2 transações com o mesmo hash da palavra-passe em 30 minutos | +30 de pontuação |
| `remote-access-high-value-transfer` | Ferramenta de acesso remoto detetada numa transferência ≥ \$5,000 | +30 de pontuação |
| `low-session-age-high-value-transfer` | Transferência ≥ \$5,000 em 30 segundos após o início da sessão | +30 de pontuação |
| `synthetic-identity-fresh-account-high-value` | Conta aberta nos últimos 7 dias transaciona ≥ \$1,000 | +30 de pontuação |

### Tomada de controlo de contas e fraude APP

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `recent-pii-change-and-transaction` | Transferência ≥ \$1,000 dentro da janela de alteração recente de PII | +45 de pontuação, `IN_REVIEW` |
| `new-payment-method-high-value` | Transferência ≥ \$5,000 com recurso a um método de pagamento adicionado nos últimos 7 dias | +30 de pontuação |
| `first-time-payee-high-value` | Transação de saída ≥ \$5,000 para uma contraparte a quem o titular nunca pagou antes | +40 de pontuação, `IN_REVIEW` |
| `consortium-flagged-counterparty` | Transferência ≥ \$500 cuja contraparte foi reportada por outra instituição | +60 de pontuação, `IN_REVIEW` |

### Abuso de afiliados e de bónus

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `repeated-bonus-campaign-from-same-fingerprint` | ≥6 transações na mesma campanha e impressão digital em 2 h | +35 de pontuação |
| `shared-fingerprint-across-bonus-campaigns` | Uma impressão digital reivindica ≥3 campanhas distintas em 7 dias | +30 de pontuação |
| `affiliate-fraud-repeated-fingerprint` | ≥5 transações no mesmo afiliado e na mesma impressão digital em 2 h | +30 de pontuação |

***

## Pacote de jogo responsável

Para aplicações de iGaming. Estas regras foram concebidas para detetar tanto sinais de proteção do jogador como padrões de abuso de bónus.

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `responsible-gaming-rapid-deposits` | ≥10 transações de entrada da mesma ação em 24 h | +20 de pontuação |
| `responsible-gaming-rapid-withdrawals` | ≥8 transações de saída da mesma ação em 24 h | +20 de pontuação |
| `responsible-gaming-cumulative-deposits-7d` | Volume de entrada ≥ \$5,000 em 7 dias | +20 de pontuação |
| `responsible-gaming-cumulative-withdrawals-7d` | Volume de levantamentos ≥ \$5,000 em 7 dias | +20 de pontuação |
| `responsible-gaming-self-excluded-activity` | Qualquer transação de uma conta com autoexclusão | +20 de pontuação |
| `responsible-gaming-loss-limit-hit` | Atividade que continua após um sinal de limite de perdas | +20 de pontuação |
| `responsible-gaming-bonus-hunting` | ≥4 transações na mesma campanha e impressão digital em 24 h | +20 de pontuação |
| `responsible-gaming-multiple-payment-methods` | ≥4 métodos de pagamento distintos em 7 dias | +20 de pontuação |
| `responsible-gaming-off-hours-high-value` | Atividade de jogo marcada como realizada fora do horário ≥ \$1,000 | +20 de pontuação |
| `responsible-gaming-failed-withdrawals` | ≥3 tentativas de levantamento falhadas | +20 de pontuação |
| `responsible-gaming-many-counterparties` | ≥5 contrapartes distintas em 24 h | +20 de pontuação |

***

## Pacote de fraude iGaming

Para operadores que enviam eventos de monitorização, além de movimentos de dinheiro. Estas regras usam `scope.record_types = ["event"]`, por isso os clientes apenas com transações não veem qualquer alteração de comportamento. Quando existe uma alternativa apenas para transações, instale a regra alternativa indicada juntamente com a regra de evento até que a sua integração envie a categoria de evento.

| `library_key` | Acionador | Ação predefinida | Alternativa apenas para transações |
| - | - | - | - |
| `igaming-account-takeover-drain` | 3+ inícios de sessão falhados, depois uma alteração de MFA, depois uma alteração do endereço de levantamento, depois um pedido de levantamento - por esta ordem, num período de 24 h | +90 à pontuação, `DECLINED` | `recent-pii-change-and-transaction`, `new-payment-method-high-value` |
| `igaming-minimal-play-laundering` | Pedido de levantamento ≥ \$1,000 enquanto o total das apostas da conta é ≤ 5% dos seus depósitos concluídos nas últimas 24h | +60 à pontuação, `IN_REVIEW` | `rapid-in-and-out-movement` |
| `igaming-chargeback-deposit-ratio` | Estornos abertos atingem pelo menos 50% dos depósitos concluídos em 30 dias | +80 à pontuação, `DECLINED` | `ecommerce-chargeback-indicator` |
| `igaming-chip-dumping-pair-net-winner` | O mesmo par P2P liquida pelo menos 2 mãos, rondas ou partidas distintas em 7 dias **e** o resultado líquido de um dos lados totaliza ≥ \$400 | +70 à pontuação, `IN_REVIEW` | Requer evento |
| `igaming-opposite-betting-same-market` | Ambos os lados da mesma partida e do mesmo mercado apostados por 2+ contas distintas que partilham uma impressão digital do dispositivo, num período de 1 h | +65 à pontuação, `IN_REVIEW` | Requer evento |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` com pontuação de bot ≥ 90 e variância temporal ≤ 10ms | +55 à pontuação, `IN_REVIEW` | Requer evento |
| `igaming-self-exclusion-evasion` | Correspondência no registo de autoexclusão com `exclusion_status: active` numa tentativa de novo registo | +100 à pontuação, `DECLINED` | `responsible-gaming-self-excluded-activity` |
| `igaming-chat-rain-farming` | Segundo resgate do **mesmo** bónus de chuva no chat por uma conta num período de 24 h, efetuado no espaço de 500 ms | +45 à pontuação, `IN_REVIEW` | `responsible-gaming-bonus-hunting` |
| `igaming-repeated-bonus-claims-one-device` | Terceiro resgate do **mesmo** bónus a partir de uma impressão digital do dispositivo em 7 dias | +50 à pontuação, `IN_REVIEW` | `repeated-bonus-campaign-from-same-fingerprint`, `shared-fingerprint-across-bonus-campaigns`, `responsible-gaming-bonus-hunting` |
| `igaming-affiliate-self-referral` | Atribuição a um código de afiliado que 3+ contas distintas usaram a partir de uma impressão digital do dispositivo em 7 dias | +50 à pontuação, `IN_REVIEW` | `affiliate-fraud-repeated-fingerprint` |
| `igaming-multi-accounting-device` | Início de sessão ou registo a partir de uma impressão digital do dispositivo usada por 3+ contas distintas num período de 24 h | +60 à pontuação, `IN_REVIEW` | `multi-accounting-shared-fingerprint` |
| `igaming-shared-proxy-ip` | Início de sessão a partir de um endereço IP usado por 3+ contas distintas num período de 24 h | +40 à pontuação, `IN_REVIEW` | `same-ip-multi-accounting` |

### Sinais de evento necessários para cada regra

Cada regra acima lê campos de evento identificados. Quando um campo obrigatório está ausente, a regra simplesmente não corresponde - nunca infere o sinal a partir de outro dado, e nunca recorre sozinha aos dados de transação. Envie as chaves abaixo no `payload` do evento e em `device_context` (consulte [Eventos](https://docs.didit.me/pt/transaction-monitoring/events.md) para o contrato completo de submissão e [Regras de evento](https://docs.didit.me/pt/transaction-monitoring/event-rules.md) para os caminhos de campos das regras).

| `library_key` | Ações de evento lidas | Campos de que a regra precisa |
| - | - | - |
| `igaming-account-takeover-drain` | `security.login_failed`, `security.mfa_changed`, `payment.withdrawal_address_changed`, `payment.withdrawal_requested` | `changed_field`, `withdrawal_address_hash`, e as chaves de pagamento padrão |
| `igaming-minimal-play-laundering` | `payment.withdrawal_requested`, `gameplay.bet_placed`, `payment.deposit_completed` | `amount` em cada um desses eventos |
| `igaming-chargeback-deposit-ratio` | `dispute.chargeback_opened`, `payment.deposit_completed` | `payment_reference_id`, mais `dispute_id` ou `chargeback_id` |
| `igaming-chip-dumping-pair-net-winner` | `gameplay.p2p_settlement` | `counterparty_vendor_data`, `net_result_amount`, e um dos seguintes: `hand_id` / `round_id` / `match_id` |
| `igaming-opposite-betting-same-market` | `gameplay.bet_placed` | `match_id`, `market_id`, `side`, `device_context.fingerprint` |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` | `device_context.bot_score`, `timing_variance_ms` |
| `igaming-self-exclusion-evasion` | `responsible_gambling.self_exclusion_match` | `exclusion_status`, `re_registration_attempt`, mais `registry_source` e `identity_match_ref` obrigatórios |
| `igaming-chat-rain-farming` | `bonus.bonus_claimed` | `bonus_id`, `bonus_type`, `claim_delay_ms` |
| `igaming-repeated-bonus-claims-one-device` | `bonus.bonus_claimed` | `bonus_id`, `device_context.fingerprint` |
| `igaming-affiliate-self-referral` | `affiliate.affiliate_attributed` | `affiliate_code`, `device_context.fingerprint` |
| `igaming-multi-accounting-device` | `security.login_succeeded`, ou um `security.registration_attempt` personalizado | `device_context.fingerprint` |
| `igaming-shared-proxy-ip` | `security.login_succeeded` | `device_context.network_context.ip_address` |

Use o pacote `igaming_fraud` quando a sua integração emitir eventos de início de sessão, jogo, bónus, afiliados, pagamento, disputa, segurança e jogo responsável. As regras são de adesão voluntária: adicioná-las à biblioteca não as instala para aplicações existentes e não altera as predefinições atuais de qualquer cliente ativo.

***

## Pacote de e-commerce

Para marketplaces e aplicações de comerciante de registo.

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `ecommerce-card-testing-microtransactions` | ≥10 transações ≤ \$5 da mesma impressão digital em 1 h | +30 de pontuação |
| `ecommerce-high-order-velocity` | ≥8 transações numa mesma impressão digital em 30 minutos | +30 de pontuação |
| `ecommerce-chargeback-indicator` | O fornecedor ou o fluxo de verificação assinalou um indicador de estorno | +30 de pontuação |
| `ecommerce-billing-country-mismatch` | Divergência do país de faturação numa transação ≥ \$500 | +30 de pontuação |
| `ecommerce-shared-payment-method` | Método de pagamento reutilizado por ≥3 sujeitos de e-commerce em 7 dias | +30 de pontuação |
| `ecommerce-shared-ip-multi-accounting` | Um endereço IP partilhado por ≥4 sujeitos de e-commerce em 24 h | +30 de pontuação |
| `ecommerce-remote-checkout-high-value` | Acesso remoto detetado na finalização da compra ≥ \$1,000 | +30 de pontuação |
| `ecommerce-affiliate-burst` | ≥5 transações do mesmo afiliado e da mesma impressão digital em 2 h | +30 de pontuação |

***

## Pacote de fraude em cheques

Para aplicações que submetem transações de depósito de cheques. Cada regra é acionada pelos sinalizadores `custom_values.check_*` que quem faz o pedido à API define quando um cheque apresenta um sinal de risco conhecido (lavagem química, MICR em falta, número de série listado na dark web, etc.).

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `check-amount-out-of-range` | Valor do cheque assinalado como fora do intervalo normal da conta E ≥ \$1,000 | +40 de pontuação, `IN_REVIEW` |
| `check-missing-or-invalid-number` | O cheque chegou com número de cheque em falta, inconsistente ou não sequencial | +35 de pontuação, `IN_REVIEW` |
| `check-duplicate-presentation` | O mesmo cheque parece ter sido depositado duas vezes (aplicação móvel + balcão) | +70 de pontuação, `IN_REVIEW` |
| `check-on-dark-web-watchlist` | O número de série ou a imagem do cheque foi encontrado num canal de divulgação de cheques roubados na dark web ou no Telegram | +90 de pontuação, `DECLINED` |
| `check-altered-or-washed` | O cheque apresenta apagamento químico, alteração do MICR ou outros indícios de lavagem | +70 de pontuação, `IN_REVIEW` |
| `check-deposit-rapid-multi-bank` | O mesmo sujeito deposita cheques em ≥3 bancos contrapartes distintos em 24 h (circulação fraudulenta de cheques) | +45 de pontuação, `IN_REVIEW` |

***

## Pacote BNPL

Para fornecedores de compra agora, paga depois (BNPL). Deteta padrões de fraude de primeira parte (falta de pagamento) e de partilha de identificadores específicos do crédito em prestações.

| `library_key` | Acionador | Ação predefinida |
| - | - | - |
| `bnpl-failed-repayment-velocity` | ≥2 pagamentos recentes falhados do sujeito: sinal de fraude de primeira parte | +45 de pontuação, `IN_REVIEW` |
| `bnpl-shared-identifier-across-accounts` | Telefone, e-mail ou morada vistos em vários sujeitos BNPL distintos | +40 de pontuação, `IN_REVIEW` |
| `bnpl-high-installment-on-fresh-account` | Prestação ≥ \$500 de uma conta aberta nos últimos 7 dias | +35 de pontuação |

***

## Referência: normas na base da biblioteca

Cada predefinição da biblioteca da Didit corresponde a uma tipologia de AML, de fraude ou de conformidade amplamente aceite. As normas em que nos apoiamos:

| Fonte | Tipologias contribuídas para a biblioteca |
| - | - |
| **Recomendações do FATF** | Fracionamento (structuring), movimentação rápida de fundos, exposição a jurisdições de alto risco, triagem de sanções sobre contrapartes |
| **Avisos da FinCEN** | Limiares de comunicação BSA / CTR, reativação de contas inativas, padrões suspeitos de numerário |
| **Regras da NACHA** | Limiares específicos de ACH e padrões fora do horário de expediente |
| **Princípios de Wolfsberg** | Tipologias de banca correspondente e de banca privada |
| **Tipologias do Grupo Egmont** | Padrões transfronteiriços e de dissimulação (layering) |
| **Boas práticas do setor** | Janelas temporais de velocidade, viagem impossível, beneficiário pela primeira vez, reutilização de impressão digital do dispositivo, sinais de fraude de primeira parte BNPL |

A Didit implementa apenas as tipologias que são normas aceites pelo setor e expõe todos os limiares para que você os possa ajustar.

***

## Personalizar predefinições

Cada predefinição pode ser:

* **Ajustada**: altere limiares, janelas, valores de pontuação ou ações por aplicação
* **Desativada**: mude uma predefinição para o modo `DISABLED` e ela deixa de ser avaliada, sem perder a sua identidade
* **Testada**: mude uma predefinição para o modo `TEST` para a avaliar em modo sombra, sem afetar os resultados das transações
* **Estendida**: crie regras personalizadas que complementam ou substituem predefinições

Consulte [Regras e pontuação](https://docs.didit.me/pt/transaction-monitoring/rules.md) para a anatomia das regras, os endpoints da API e exemplos práticos de criação de regras personalizadas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.