> ## 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: 150+ cenários predefinidos

> Didit: 150+ regras KYT (structuring, velocidade, layering, sanções, dispositivo, cripto, Travel Rule, iGaming). 1,000/mês inclusas; depois $0.001.

A Didit oferece uma biblioteca selecionada com **mais de 150 regras predefinidas de monitoramento de transações**, que você pode instalar individualmente ou por pacote. Cada regra corresponde a uma tipologia real de AML, fraude ou conformidade, extraída de padrões globais e orientações regulatórias: recomendações do FATF, alertas da FinCEN, regras da NACHA, princípios de Wolfsberg, tipologias do Egmont Group e padrões de abuso em iGaming.

Escolha as regras predefinidas ou os pacotes de que você precisa e, depois, controle o modo de cada regra instalada (`ACTIVE`, `TEST` ou `DISABLED`). As condições, os limiares e as ações das regras predefinidas são fixos. Crie uma regra personalizada quando precisar de uma lógica diferente. Desinstale uma regra predefinida para removê-la da aplicação e reinstale-a depois, se necessário.

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

> [!NOTE]
>
> Uma regra da biblioteca cujas condições leem dados que o mecanismo de regras ainda não consegue avaliar fica **retida** até que possa ser executada. A biblioteca não a lista. Uma requisição que a cite em `library_keys` retorna `400` e não instala nada (uma chave desconhecida, por outro lado, é ignorada). Uma instalação por `bundle` a ignora. Uma cópia que você instalou anteriormente é desativada (`DISABLED`) e permanece na sua lista de regras, e definir o `mode` dela com qualquer outro valor retorna `400`. Uma regra retida volta automaticamente assim que o mecanismo de regras consegue avaliar suas condições, de modo que a lista da biblioteca sempre mostra as regras que você pode instalar hoje.

## Como as regras predefinidas são organizadas

Toda regra predefinida pertence a um **pacote** (sua família funcional) e a uma **categoria** (seu tema de risco mais amplo). Os pacotes permitem ativar e desativar regras relacionadas em conjunto pelo painel. As categorias orientam a pontuação e os relatórios.

| Pacote | O que abrange |
| - | - |
| `finance` | Fracionamento (structuring), transações de alto valor, volume acumulado, dispersão entre países, ocultação (layering), concentração de recursos em contas de laranjas (fan-in), smurfing |
| `aml_ctf` | Sanções, referências de pagamento suspeitas, ocultação com valores redondos, entrada e saída rápidas de recursos |
| `aml_monitoring` | Exposição a origens dos recursos de alto risco derivadas de blockchain, financiamento do terrorismo, exploração infantil |
| `anomaly_detection` | Alta frequência, reativação de contas inativas, atividade fora do horário habitual |
| `fatf` | Exposição a jurisdições de alto risco |
| `device_intelligence` | Reutilização de impressão digital do dispositivo, contas com várias impressões digitais, anomalias de IP/navegador, VPN/proxy, viagem impossível |
| `fraud_prevention_multi_accounting` | Impressões digitais compartilhadas entre titulares distintos |
| `fraud_prevention_app` | Sinais de pagamento push autorizado (APP), de pagamento a um beneficiário pela primeira vez e de vítima de golpe |
| `fraud_prevention_ato` | Sinais compostos de tomada de conta (alteração de dados pessoais, novo meio de pagamento) |
| `fraud_prevention_consortium` | Contrapartes sinalizadas por outras instituições na rede compartilhada |
| `crypto_monitoring` | Exposição a carteiras de mixers, darknet ou sancionadas, chain hopping, carteiras não hospedadas, lacunas de VASP |
| `travel_rule` | Obrigações globais e regionais da Travel Rule (12 regimes) e due diligence de VASPs de contraparte |
| `travel_rule_eu_tfr` | Verificações do TFR da UE: divergência nos dados da contraparte, propriedade de carteira não verificada, VASP de contraparte não identificado, confirmação expirada |
| `responsible_gaming` | Limites de depósito/saque para jogo seguro, autoexclusão, jogo fora do horário habitual |
| `igaming_fraud` | Abuso de bônus vinculados a eventos, apostas opostas, fraude de afiliados, farming de chat rain, chip dumping, tomada de conta |
| `e_commerce` | Microtransações para teste de cartões, indicadores de chargeback, divergência do país de faturamento, picos de atividade de afiliados |
| `check_fraud` | Cheques fora da faixa, com número ausente, apresentados em duplicidade, em lista de monitoramento da dark web ou adulterados (washed), kiting |
| `bnpl` | Fraude de primeira parte com falha no pagamento de parcelas, identificadores compartilhados entre contas BNPL, parcelamentos em contas recém-criadas |

## Como ler esta página

Cada regra lista sua `library_key` (identificador estável que você pode referenciar na API ou na URL do console), as condições e a agregação que a disparam e as ações padrão que ela executa. Os limiares numéricos mostrados aqui são os valores padrão fornecidos. Todos os valores podem ser editados por aplicação sem que a regra perca sua identidade.

***

## Pacote de finanças

Estas regras se aplicam a toda transação com `transaction_type = FINANCE`. Elas modelam a base regulatória (limiares de comunicação do BSA/FinCEN, heurísticas de velocidade do FATF), além de padrões de contas laranja e de smurfing.

### Fracionamento e valores próximos ao limiar

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `structuring-inbound` | ≥20 transferências de entrada abaixo de \$10,000 feitas pelo mesmo titular em até 30 dias | +35 na pontuação |
| `structuring-outbound` | ≥20 transferências de saída abaixo de \$10,000 feitas pelo mesmo titular em até 30 dias | +35 na pontuação |
| `single-transaction-just-below-threshold` | Uma única transação entre $9,000 e $9,999 | +25 na pontuação |
| `round-amount-layering` | O valor da transferência corresponde a um valor suspeitamente redondo ($10k, $25k, $50k, $100k, $250k, $500k, \$1M…) | +20 na pontuação |

### Volume e velocidade

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

### Ocultação (layering), contas laranja e smurfing

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `rapid-in-and-out-movement` | Uma saída precedida por uma entrada em até 6 horas | +60 na pontuação, `IN_REVIEW` |
| `cash-deposit-followed-by-withdrawal` | Depósitos em espécie ≥ \$50,000 em 72h seguidos de um saque em espécie | +30 na pontuação, `IN_REVIEW` |
| `money-mule-fan-in-to-counterparty` | Uma contraparte recebe transferências de ≥5 titulares distintos em 7 dias | +30 na pontuação, `IN_REVIEW` |
| `rapid-repeated-payments-same-counterparty` | ≥5 transferências de saída para a mesma contraparte em 24 horas | +30 na pontuação, `IN_REVIEW` |
| `cross-border-small-amount-velocity` | Um titular envia valores abaixo de \$1,000 para contrapartes em ≥4 países distintos em 24h | +30 na pontuação, `IN_REVIEW` |
| `high-risk-jurisdiction-smurfing` | ≥5 transferências de saída abaixo de \$1,000 para o mesmo país de alto risco em 7 dias | +30 na pontuação, `IN_REVIEW` |
| `many-unique-counterparties-24h` | O titular transaciona com ≥6 contrapartes distintas em 24h | +30 na pontuação, `IN_REVIEW` |
| `many-unique-payment-methods-7d` | O titular alterna entre ≥4 métodos de pagamento distintos em 7 dias | +30 na pontuação, `IN_REVIEW` |
| `counterparty-country-spread-24h` | O titular transaciona com contrapartes em ≥4 países distintos em 24h | +30 na pontuação, `IN_REVIEW` |

### Anomalias comportamentais

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `dormant-account-reactivation` | Primeira transação ≥ \$1,000 após ≥365 dias de inatividade | +20 na pontuação |
| `off-hours-high-value-finance` | Transferência de alto valor (≥ \$5,000) marcada como fora do horário habitual para a localidade do titular | +25 na pontuação |

***

## Pacote AML / CTF

Estas regras modelam tipologias clássicas de AML/CTF que não dependem de enriquecimento de blockchain: elas se aplicam universalmente a transferências em moeda fiduciária e em cripto.

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `sanctions-counterparty` | A própria carteira analisada é atribuída a uma entidade sancionada (`wallet_sanctioned`). A exposição por si só não aciona esta regra | +90 na pontuação, `DECLINED` |
| `sanctions-exposure-review` | A carteira analisada movimentou fundos de ou para entidades sancionadas sem ser ela própria sancionada | +50 na pontuação, `IN_REVIEW` |
| `suspicious-payment-reference` | A referência do pagamento contém palavras-chave associadas a recursos de origem ilícita | +45 na pontuação, `IN_REVIEW` |
| `high-risk-jurisdiction-exposure` | O país da contraparte ou o país associado ao IP do sujeito está na lista de alto risco | +40 na pontuação, `IN_REVIEW` |
| `high-risk-inbound-single` | Entrada ≥ \$20,000 vinda de um país de alto risco | +30 na pontuação, `IN_REVIEW` |
| `high-risk-outbound-single` | Saída ≥ \$20,000 para um país de alto risco | +30 na pontuação, `IN_REVIEW` |

A lista padrão de jurisdições de alto risco já vem com os territórios sujeitos a apelo à ação do FATF e as regiões de conflito: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`. Você pode substituir a lista por aplicação.

> [!NOTE]
>
> **A cobertura de contrapartes PEP não é oferecida no momento.** Nenhum provedor de triagem conectado informa se uma contraparte é uma pessoa politicamente exposta: hoje, o campo `pep_counterparty` é `null` em todos os resultados de triagem (consulte [triagem de carteiras](https://docs.didit.me/pt-br/transaction-monitoring/wallet-screening.md#resposta)), por isso a biblioteca não tem um preset para contrapartes PEP. Uma regra instalada antes da retirada desse preset continua sendo avaliada, mas não pode ser acionada por uma triagem real: remova-a ou substitua-a por uma regra personalizada se você precisar agir com base em outro sinal.

***

## Pacote de triagem cripto

Estas regras consomem os dados enriquecidos produzidos pela triagem cripto da Didit: elas são mais úteis para aplicações cripto-nativas e de VASPs.

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `aml-high-risk-source-exposure` | ≥30% dos fundos de origem vêm das categorias sancionadas, darknet, roubadas, ransomware ou golpes | +70 na pontuação, `IN_REVIEW` |
| `aml-multiple-risky-counterparties` | ≥3 conexões com entidades de alto risco no grafo de origem dos recursos | +50 na pontuação, `IN_REVIEW` |
| `aml-terrorist-financing-exposure` | Qualquer exposição a financiamento do terrorismo na carteira | +100 na pontuação, `DECLINED` |
| `aml-child-exploitation-exposure` | Qualquer exposição a material de exploração infantil na carteira | +100 na pontuação, `DECLINED` |
| `aml-wallet-risk-score-medium` | Pontuação de risco da carteira informada pelo provedor entre 40 e 70 | +30 na pontuação |

***

## Pacote de monitoramento cripto

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

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `crypto-mixer-exposure` | Carteira vinculada a um mixer ou serviço de ofuscação | +80 de pontuação, `IN_REVIEW` |
| `crypto-darknet_market-exposure` | Exposição a uma carteira associada a um mercado da darknet | +80 de pontuação, `IN_REVIEW` |
| `crypto-sanctioned-exposure` | Exposição a uma carteira sancionada | +90 de pontuação, `IN_REVIEW` |
| `crypto-stolen_funds-exposure` | Exposição a uma carteira com fundos roubados | +85 de pontuação, `IN_REVIEW` |
| `crypto-scam-exposure` | Exposição a uma carteira associada a um golpe | +70 de pontuação, `IN_REVIEW` |
| `crypto-ransomware-exposure` | Exposição a uma carteira associada a ransomware | +90 de pontuação, `IN_REVIEW` |
| `crypto-hacked_exchange-exposure` | Exposição a uma carteira associada a uma exchange hackeada | +80 de pontuação, `IN_REVIEW` |
| `crypto-gambling_unlicensed-exposure` | Exposição a uma carteira associada a jogos de azar sem licença | +60 de pontuação, `IN_REVIEW` |
| `high-risk-wallet-exposure` | A carteira está associada a mercado da darknet, sanções ou fundos roubados | +70 de pontuação, `IN_REVIEW` |
| `crypto-wallet-risk-score-critical` | Pontuação da carteira pelo provedor ≥ 90 | +90 de pontuação, `IN_REVIEW` |
| `crypto-wallet-risk-score-high` | Pontuação da carteira pelo provedor ≥ 70 | +60 de pontuação, `IN_REVIEW` |
| `crypto-unhosted-wallet-large-outbound` | Transferência de saída ≥ \$1,000 para uma carteira autocustodiada | +45 de pontuação, `IN_REVIEW` |
| `crypto-repeated-unhosted-wallet-withdrawals` | ≥5 transferências de saída para carteiras autocustodiadas em 24h | +35 de pontuação, `IN_REVIEW` |
| `crypto-many-new-wallets-per-subject` | O titular envia para ≥5 carteiras distintas em 24h | +40 de pontuação, `IN_REVIEW` |
| `crypto-chain-hopping-pattern` | O mesmo titular movimenta fundos entre ≥3 blockchains em 24h | +45 de pontuação, `IN_REVIEW` |
| `crypto-missing-vasp-id-high-value` | Transferência a partir de carteira custodiada ≥ \$1,000 sem identificador de VASP | +30 de pontuação, `IN_REVIEW` |

***

## Pacote Travel Rule

As regras de Travel Rule se aplicam somente a transações `travelRule`.
Cada regime regional inclui quatro regras (contraparte pendente, ação pendente, dados ausentes, troca com falha).

### Travel Rule global

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `travel-rule-pending-counterparty` | O status é `AWAITING_COUNTERPARTY` (aguardando o VASP da contraparte) | +35 de pontuação, `IN_REVIEW` |
| `travel-rule-pending-action` | O status é `ON_HOLD` (em uma troca gerenciada, uma transferência de entrada aguardando que você a resolva: nenhuma correspondência na lista de endereços de carteira ou uma consulta aguardando aprovação manual) | +35 de pontuação, `AWAITING_USER` |
| `travel-rule-missing-required-data` | `travel_rule_required` é `true` e `travel_rule_obligations_count` é maior que `0`; somente os dados de Travel Rule que você mesmo registra em `travel_rule_details` têm contagem de obrigações, então esta regra nunca é acionada em uma transferência executada pela troca gerenciada | +50 de pontuação, `IN_REVIEW` |

### Regimes regionais

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

A marcação do regime é automática: a Didit grava `custom_values.travel_rule_regime` em toda transação de Travel Rule com base no `jurisdiction` das suas [configurações de Travel Rule](https://docs.didit.me/pt-br/transaction-monitoring/travel-rule.md#configuração) - `SG` → `singapore`, `GB` → `uk` e qualquer código de país membro da UE ou do EEE, como `DE` ou `FR` → `eu`. Códigos sem pacote regional são gravados em minúsculas (`US` → `us`), para que regras personalizadas ainda possam ser direcionadas a eles. Um valor `props.travel_rule_regime` enviado na transação sempre substitui o regime derivado.

| Modelo de `library_key` | Gatilho |
| - | - |
| `travel-rule-<regime>-pending-counterparty` | Transferência marcada com o regime aguardando o VASP da contraparte |
| `travel-rule-<regime>-pending-action` | Transferência marcada com o regime está `ON_HOLD` |
| `travel-rule-<regime>-missing-required-data` | Transferência marcada com o regime é obrigatória, mas não foi resolvida |
| `travel-rule-<regime>-failed-exchange` | Transferência marcada com o regime está `CANCELLED` |

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

### Due diligence da contraparte

Estas regras leem o que a sua aplicação sabe sobre o VASP da contraparte que a corretora contatou: sua própria decisão sobre ele, o nível de risco da due diligence desse VASP, seu país e sua capacidade de resposta.
Consulte [Due diligence da contraparte](https://docs.didit.me/pt-br/transaction-monitoring/travel-rule.md#due-diligence-de-contrapartes) para saber de onde vem cada valor.

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `travel-rule-counterparty-blocked` | A sua decisão sobre a contraparte (`counterparty_dd_status`) é `BLOCKED` | +90 de pontuação, `DECLINED` |
| `travel-rule-counterparty-restricted` | A sua decisão sobre a contraparte é `RESTRICTED` | +50 de pontuação, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk` | O nível de risco da contraparte (`counterparty_risk_level`) é `HIGH`: uma pontuação de due diligence abaixo de 40, ou a sua própria triagem recente da contraparte encontrou uma possível correspondência em sanções ou mídia adversa | +40 de pontuação, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk-jurisdiction` | A contraparte está estabelecida em um país da lista padrão de alto risco (`IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`) | +60 de pontuação, `IN_REVIEW` |
| `travel-rule-counterparty-unresponsive` | A contraparte respondeu a menos de 10 por cento das requisições de Travel Rule que clientes da Didit lhe enviaram nos últimos 90 dias, com pelo menos 5 delas decididas | +30 de pontuação, `IN_REVIEW` |

***

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

Estas regras transformam sinais do SDK do cliente (fingerprint do dispositivo, IP, navegador, idade da sessão) e o enriquecimento de provedores em eventos de detecção de fraude.

### Fingerprint do dispositivo e múltiplas contas

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `multi-accounting-shared-fingerprint` | Um fingerprint de dispositivo reutilizado por ≥3 titulares distintos em 7 dias | +50 de pontuação, `IN_REVIEW` |
| `multiple-device-fingerprints-for-same-subject` | Um titular aparece em ≥3 fingerprints distintos em 24h | +20 de pontuação |
| `same-fingerprint-transaction-burst` | ≥6 transações de um mesmo fingerprint em 24h | +30 de pontuação |
| `same-ip-multi-accounting` | Um IP compartilhado por ≥3 titulares distintos em 7 dias | +30 de pontuação |
| `same-ip-transaction-burst` | ≥6 transações de um mesmo IP em 24h | +30 de pontuação |
| `same-fingerprint-multiple-payment-methods` | Um fingerprint alternando 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 usa ≥4 IPs distintos em 24h | +30 de pontuação |
| `new-browser-and-new-ip-combination` | O titular apresenta ≥3 navegadores distintos E ≥3 IPs distintos em 24h | +30 de pontuação |

### IP, rede e VPN

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `vpn-or-proxy-high-value` | VPN ou proxy detectado em uma transferência ≥ \$5,000 | +30 de pontuação |
| `impossible-travel-between-transactions` | O titular faz transações a partir de IPs de ≥2 países distintos em até 1 hora | +30 de pontuação |

### Sinais comportamentais combinados

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `browser-spoofing-password-reuse` | Spoofing de navegador detectado E ≥2 transações reutilizando o mesmo hash de senha em 30 minutos | +30 de pontuação |
| `remote-access-high-value-transfer` | Ferramenta de acesso remoto detectada em uma transferência ≥ \$5,000 | +30 de pontuação |
| `low-session-age-high-value-transfer` | Transferência ≥ \$5,000 em até 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 movimenta ≥ \$1,000 | +30 de pontuação |

### Sequestro de conta e fraude APP

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `recent-pii-change-and-transaction` | Transferência ≥ \$1,000 dentro da janela de alteração recente de dados pessoais (PII) | +45 de pontuação, `IN_REVIEW` |
| `new-payment-method-high-value` | Transferência ≥ \$5,000 usando um método de pagamento adicionado nos últimos 7 dias | +30 de pontuação |
| `first-time-payee-high-value` | Transferência de saída ≥ \$5,000 para uma contraparte à qual 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 bônus

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

***

## Pacote de jogo responsável

Para aplicações de iGaming. Estas regras foram projetadas para detectar tanto sinais de proteção ao jogador quanto padrões de abuso de bônus.

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `responsible-gaming-rapid-deposits` | ≥10 transações de entrada da mesma ação em 24h | +20 de pontuação |
| `responsible-gaming-rapid-withdrawals` | ≥8 transações de saída da mesma ação em 24h | +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 saída ≥ \$5,000 em 7 dias | +20 de pontuação |
| `responsible-gaming-self-excluded-activity` | Qualquer transação de uma conta autoexcluída | +20 de pontuação |
| `responsible-gaming-loss-limit-hit` | A atividade continua após um sinal de limite de perdas | +20 de pontuação |
| `responsible-gaming-bonus-hunting` | ≥4 transações com a mesma campanha + mesmo fingerprint em 24h | +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 marcada como fora do horário ≥ \$1,000 | +20 de pontuação |
| `responsible-gaming-failed-withdrawals` | ≥3 tentativas de saque malsucedidas | +20 de pontuação |
| `responsible-gaming-many-counterparties` | ≥5 contrapartes distintas em 24h | +20 de pontuação |

***

## Pacote de fraude em iGaming

Para operadores que enviam eventos de monitoramento além das movimentações financeiras. Essas regras usam `scope.record_types = ["event"]`, então clientes que enviam apenas transações não percebem nenhuma mudança de comportamento. Quando existe uma alternativa baseada apenas em transações, instale a regra alternativa indicada junto com a regra de evento até que sua integração envie a categoria de evento.

| `library_key` | Gatilho | Ação padrão | Alternativa apenas com transações |
| - | - | - | - |
| `igaming-account-takeover-drain` | 3+ logins com falha, depois uma alteração de MFA, depois uma alteração do endereço de saque e, por fim, uma solicitação de saque, nessa ordem, em até 24h | +90 de pontuação, `DECLINED` | `recent-pii-change-and-transaction`, `new-payment-method-high-value` |
| `igaming-minimal-play-laundering` | Solicitação de saque ≥ \$1,000 enquanto o total de apostas da conta é ≤ 5% dos depósitos concluídos nas 24h anteriores | +60 de pontuação, `IN_REVIEW` | `rapid-in-and-out-movement` |
| `igaming-chargeback-deposit-ratio` | Os chargebacks abertos chegam a pelo menos 50% dos depósitos concluídos em 30 dias | +80 de pontuação, `DECLINED` | `ecommerce-chargeback-indicator` |
| `igaming-chip-dumping-pair-net-winner` | O mesmo par P2P liquida pelo menos 2 mãos, rodadas ou partidas distintas em 7 dias **e** o resultado líquido de um dos lados totaliza ≥ \$400 | +70 de pontuação, `IN_REVIEW` | Evento obrigatório |
| `igaming-opposite-betting-same-market` | Apostas em ambos os lados da mesma partida e do mesmo mercado feitas por 2+ contas distintas que compartilham uma impressão digital de dispositivo, em até 1h | +65 de pontuação, `IN_REVIEW` | Evento obrigatório |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` informando pontuação de bot ≥ 90 e variação de tempo ≤ 10ms | +55 de pontuação, `IN_REVIEW` | Evento obrigatório |
| `igaming-self-exclusion-evasion` | Correspondência no registro de autoexclusão com `exclusion_status: active` em uma tentativa de novo cadastro | +100 de pontuação, `DECLINED` | `responsible-gaming-self-excluded-activity` |
| `igaming-chat-rain-farming` | Segundo resgate do **mesmo** bônus de chat rain por uma conta em 24h, resgatado em até 500ms | +45 de 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 de dispositivo em 7 dias | +50 de 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 de dispositivo em 7 dias | +50 de pontuação, `IN_REVIEW` | `affiliate-fraud-repeated-fingerprint` |
| `igaming-multi-accounting-device` | Login ou cadastro a partir de uma impressão digital de dispositivo usada por 3+ contas distintas em 24h | +60 de pontuação, `IN_REVIEW` | `multi-accounting-shared-fingerprint` |
| `igaming-shared-proxy-ip` | Login a partir de um endereço IP usado por 3+ contas distintas em 24h | +40 de pontuação, `IN_REVIEW` | `same-ip-multi-accounting` |

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

Todas as regras acima leem campos de evento nomeados. Quando um campo obrigatório está ausente, a regra simplesmente não corresponde: ela nunca infere o sinal com base em outro dado e nunca recorre sozinha aos dados de transação. Envie as chaves abaixo no `payload` e no `device_context` do evento (consulte [Eventos](https://docs.didit.me/pt-br/transaction-monitoring/events.md) para o contrato completo de envio e [Regras de evento](https://docs.didit.me/pt-br/transaction-monitoring/event-rules.md) para os caminhos de campo 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`, além de `dispute_id` ou `chargeback_id` |
| `igaming-chip-dumping-pair-net-winner` | `gameplay.p2p_settlement` | `counterparty_vendor_data`, `net_result_amount` e um entre `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`, além dos obrigatórios `registry_source` e `identity_match_ref` |
| `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 sua integração emitir eventos de login, gameplay, bônus, afiliados, pagamento, disputa, segurança e jogo responsável. As regras continuam sendo opcionais: adicioná-las à biblioteca não as instala em aplicações existentes e não altera os presets atuais de nenhum cliente ativo.

***

## Pacote de e-commerce

Para marketplaces e aplicações que atuam como merchant of record.

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `ecommerce-card-testing-microtransactions` | ≥10 transações ≤ \$5 a partir do mesmo fingerprint em 1h | +30 de pontuação |
| `ecommerce-high-order-velocity` | ≥8 transações no mesmo fingerprint em 30 minutos | +30 de pontuação |
| `ecommerce-chargeback-indicator` | O provedor ou o fluxo sinalizou um indicador de chargeback | +30 de pontuação |
| `ecommerce-billing-country-mismatch` | Divergência do país de faturamento em uma transação ≥ \$500 | +30 de pontuação |
| `ecommerce-shared-payment-method` | Método de pagamento reutilizado por ≥3 titulares de e-commerce em 7 dias | +30 de pontuação |
| `ecommerce-shared-ip-multi-accounting` | Um mesmo IP compartilhado entre ≥4 titulares de e-commerce em 24h | +30 de pontuação |
| `ecommerce-remote-checkout-high-value` | Acesso remoto detectado em um checkout ≥ \$1,000 | +30 de pontuação |
| `ecommerce-affiliate-burst` | ≥5 transações com o mesmo afiliado + fingerprint em 2h | +30 de pontuação |

***

## Pacote de fraude com cheques

Para aplicações que enviam transações de depósito de cheques. Cada regra é acionada por flags `custom_values.check_*` que o chamador define quando um cheque apresenta um sinal de risco conhecido (lavagem química, MICR ausente, número de série listado na dark web etc.).

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `check-amount-out-of-range` | Valor do cheque sinalizado como fora da faixa normal da conta E ≥ \$1,000 | +40 de pontuação, `IN_REVIEW` |
| `check-missing-or-invalid-number` | O cheque chegou com número ausente, inconsistente ou fora de sequência | +35 de pontuação, `IN_REVIEW` |
| `check-duplicate-presentation` | O mesmo cheque parece ter sido depositado duas vezes (celular + agência) | +70 de pontuação, `IN_REVIEW` |
| `check-on-dark-web-watchlist` | O número de série ou a imagem do cheque foi encontrado em um feed de cheques roubados da dark web ou do Telegram | +90 de pontuação, `DECLINED` |
| `check-altered-or-washed` | O cheque apresenta apagamento químico, alteração do MICR ou outro indício de lavagem química | +70 de pontuação, `IN_REVIEW` |
| `check-deposit-rapid-multi-bank` | O mesmo titular deposita cheques em ≥3 bancos de contraparte distintos em 24h (kiting) | +45 de pontuação, `IN_REVIEW` |

***

## Pacote de BNPL

Para provedores de buy now, pay later (compre agora, pague depois). Identifica padrões de fraude primária (inadimplência intencional) e de compartilhamento de identificadores específicos do crédito parcelado.

| `library_key` | Gatilho | Ação padrão |
| - | - | - |
| `bnpl-failed-repayment-velocity` | ≥2 pagamentos de parcelas recentes com falha no titular: sinal de fraude primária | +45 de pontuação, `IN_REVIEW` |
| `bnpl-shared-identifier-across-accounts` | Telefone, e-mail ou endereço já foram vistos em vários titulares de BNPL distintos | +40 de pontuação, `IN_REVIEW` |
| `bnpl-high-installment-on-fresh-account` | Parcela ≥ \$500 de uma conta aberta nos últimos 7 dias | +35 de pontuação |

***

## Referência: padrões por trás da biblioteca

Cada preset da biblioteca da Didit corresponde a uma tipologia de AML, fraude ou conformidade amplamente aceita. Os padrões em que nos baseamos:

| Fonte | Tipologias incorporadas à biblioteca |
| - | - |
| **Recomendações do FATF** | Fracionamento (structuring), movimentação rápida de recursos, exposição a jurisdições de alto risco, triagem de contrapartes em listas de sanções |
| **Alertas do FinCEN** | Limiares de comunicação BSA / CTR, reativação de contas inativas, padrões suspeitos com dinheiro em espécie |
| **Regras da NACHA** | Limiares específicos de ACH e padrões fora do horário comercial |
| **Princípios de Wolfsberg** | Tipologias de correspondência bancária e private banking |
| **Tipologias do Egmont Group** | Padrões transfronteiriços e de ocultação (layering) |
| **Boas práticas do setor** | Janelas de monitoramento de frequência, viagem impossível, primeiro pagamento a um novo beneficiário, reutilização de fingerprint de dispositivo, sinais de fraude de primeira parte em BNPL |

A Didit implementa apenas as tipologias que são padrões aceitos no setor e expõe todos os limiares para que você os ajuste.

***

## Personalização de presets

Todo preset pode ser:

* **Ajustado**: altere limiares, janelas, valores de pontuação ou ações por aplicação
* **Desativado**: coloque um preset no modo `DISABLED` e ele deixa de ser avaliado sem perder sua identidade
* **Testado**: coloque um preset no modo `TEST` para avaliá-lo em modo sombra, sem afetar os resultados das transações
* **Estendido**: crie regras personalizadas que complementam ou substituem os presets

Consulte [Regras e pontuação](https://docs.didit.me/pt-br/transaction-monitoring/rules.md) para ver 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.