Pular para o conteúdo principal
Toda transação que você envia com um identificador vendor_data (seja como requerente ou como contraparte) fica vinculada à entidade de usuário correspondente. O perfil do usuário passa a ser um registro contínuo da atividade da pessoa, e o Monitoramento de transações usa esse histórico para alimentar as regras de frequência e comportamentais.

​
Como recuperar as transações de um usuário

Filtre a lista de transações por vendor_data:
Retorna todas as transações em que o usuário é o requerente. Para o histórico da contraparte, filtre no Business Console (o endpoint público de listagem filtra apenas por requerente).

​
Como as transações são vinculadas aos usuários

Cada transação inclui até quatro partes (requerente, remetente, beneficiário, contraparte). Quando uma parte inclui vendor_data, a Didit a vincula a esse usuário. As partes sem vendor_data são armazenadas como snapshots externos (sem vínculo com uma entidade). Consulte envio de transações para ver o modelo completo de partes.

​
Sinais de risco agregados

As transações alimentam os seguintes sinais no nível do usuário: Esses sinais são calculados em tempo real e avaliados com base nas suas regras de transação ativas. Quando uma regra é atendida, o status do usuário pode ser alterado automaticamente para FLAGGED ou BLOCKED, dependendo da ação da regra.

​
Como as regras atuam sobre os usuários

As actions de uma regra de transação podem incluir:
  • add_score: aumenta a pontuação de risco da transação.
  • change_status: define o status da transação (IN_REVIEW, DECLINED, AWAITING_USER).
  • add_tags: adiciona tags à transação.
  • add_to_list: adiciona o vendor_data do usuário a uma lista de bloqueio ou a uma lista personalizada.
Quando uma regra adiciona o usuário a uma lista de bloqueio, a entidade User dele passa para BLOCKED e um webhook user.status.updated é disparado.

​
Como monitorar o comportamento de um usuário

Use a aba Transações na página de detalhes do usuário no Business Console para:
  • Ver todas as transações em ordem cronológica.
  • Filtrar por status, valor, direção e contraparte.
  • Abrir qualquer transação para inspecionar as execuções de regras, o enriquecimento de IP e os resultados da triagem de cripto.
  • Abrir um caso para o usuário para acompanhar uma investigação.

​
Sessões de remediação

Quando uma transação entra em AWAITING_USER, a Didit cria uma sessão de remediação vinculada, que exige que o usuário conclua uma verificação adicional (por exemplo, documentação de origem dos recursos ou um documento de identidade atualizado). A sessão de remediação está vinculada ao mesmo vendor_data: ao ser concluída, o status da transação é atualizado automaticamente. Consulte status das transações para ver a máquina de estados completa.

​
Ingestão de histórico

Para carregar transações históricas em uma entidade User existente, envie txn_date com uma data no passado:
As transações históricas também passam pelo mecanismo de regras. Se você quiser importar o histórico sem acionar regras, use o fluxo de importação do console, que oferece um modo de “dry ingest”.

​
Próximos passos

Enviar transações

Referência completa do payload.

Regras

Como as regras avaliam transações e atuam sobre os usuários.

Status

Referência de status de transação e de remediação.
Última modificação em 1 de novembro de 2026