API de listas da Didit: listas de bloqueio e de permissão

A API de Listas permite gerenciar listas tipadas para a sua aplicação. As listas de bloqueio do sistema são criadas automaticamente e verificadas durante a verificação e a triagem de transações. Você também pode criar listas de permissão e listas personalizadas para condições de workflow.

Conceitos

Tipo	Descrição
Lista de bloqueio	Criada pelo sistema, uma para cada tipo de item. Itens em uma lista de bloqueio causam recusa automática durante a verificação ou a triagem de transações.
Lista de permissão	Criada pelo usuário. Usada em condições do fluxo e para suprimir ações duplicadas ou de reutilização para itens confiáveis com correspondência.
Personalizada	Criada pelo usuário. Listas flexíveis para ramificações do fluxo, regras de monitoramento ou revisão manual.

Tipos de entrada

Tipo de entrada	Verificado durante	Em caso de correspondência
`face`	Verificação de prova de vida	Sessão recusada
`document`	Verificação de identidade (OCR)	Sessão recusada
`phone`	Verificação de telefone	Sessão recusada
`email`	Verificação de e-mail	Sessão recusada
`ip_address`	Análise de dispositivo e IP (suporta intervalos CIDR)	Sessão recusada
`device_fingerprint`	Análise de dispositivo e IP	Sessão recusada
`wallet_address`	Triagem de transações	Transação recusada
`bank_account`	Triagem de transações	Transação recusada
`user`	Triagem de transações	Usuário bloqueado
`business`	Triagem de transações	Empresa bloqueada
`country`	Condições do fluxo	Configurável
`key`	Uso personalizado	Configurável

Listas de permissão

As listas de permissão não substituem as listas de bloqueio nem às verificações de autenticidade. Elas apenas suprimem ações de duplicidade/reutilização para o mesmo tipo de entrada. Por exemplo, um rosto em uma lista de permissão de rostos pode ignorar a ação DUPLICATED_FACE, um IP em uma lista de permissão de IPs pode ignorar a ação DUPLICATED_IP_ADDRESS e uma impressão digital do dispositivo em uma lista de permissão de dispositivos pode ignorar a ação DUPLICATED_DEVICE_FINGERPRINT. A Didit ainda registra um aviso informativo da lista de permissão para que você possa auditar por que a ação de duplicidade não foi executada.

Listas de bloqueio do sistema

Toda aplicação recebe automaticamente 10 listas de bloqueio do sistema (uma por tipo de entrada suportado) e uma lista do sistema High Risk Countries. Elas não podem ser excluídas nem renomeadas. Você pode adicionar entradas a elas pela API ou pelo console.

Rastreabilidade

Toda entrada de lista de bloqueio pode ser vinculada à sua entidade de origem, para que você possa navegar da lista até o registro original:

A partir de uma sessão: envie reference_session_id ao criar uma entrada. A Didit extrai automaticamente o valor (rosto, documento, telefone, e-mail, IP ou dispositivo), marca o modelo subjacente como incluído na lista de bloqueio e vincula a entrada à sessão. A Didit lê o registro mais recente desse tipo na sessão; para incluir na lista um valor de um registro anterior, adicione-o por value sem reference_session_id.
A partir de uma transação, usuário ou empresa: envie reference_object_uuid com o UUID da entidade e inclua metadata.reference_type ("transaction", "vendor_user" ou "vendor_business") para que o console possa vincular ao registro original.

Endpoints

Listar todas as listas

Recupere todas as listas de uma aplicação.

Listar entradas

Recupere as entradas de uma lista.

Criar entrada

Adicione um valor a uma lista de bloqueio, por valor, por referência de sessão ou por referência de transação.

Excluir entrada

Remova uma entrada e desbloqueie a entidade associada.

Enviar rosto

Envie uma imagem de rosto diretamente para uma lista de bloqueio facial.

​Conceitos

​Tipos de entrada

​Listas de permissão

​Listas de bloqueio do sistema

​Rastreabilidade

​Endpoints