API de listas de bloqueio e de permissão

A API de Listas permite-lhe gerir listas tipificadas 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. Também pode criar listas de permissão e listas personalizadas para condições do fluxo.

Conceitos

Tipo	Descrição
Lista de bloqueio	Criada pelo sistema, uma por tipo de entrada. Os itens de uma lista de bloqueio provocam a recusa automática durante a verificação ou a triagem de transações.
Lista de permissão	Criada pelo utilizador. Usada em condições do fluxo e para suprimir ações de duplicação/reutilização em itens correspondentes considerados de confiança.
Personalizado	Criada pelo utilizador. Listas flexíveis para ramificação de fluxos, regras de monitorização 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	Utilizador bloqueado
`business`	Triagem de transações	Empresa bloqueada
`country`	Condições do fluxo	Configurável
`key`	Utilização personalizada	Configurável

Listas de permissão

As listas de permissão não se sobrepõem às listas de bloqueio nem às verificações de autenticidade. Apenas suprimem ações de duplicação/reutilização para o mesmo tipo de entrada. Por exemplo, uma face numa lista de permissão de faces pode ignorar a ação DUPLICATED_FACE, um IP numa lista de permissão de IP pode ignorar a ação DUPLICATED_IP_ADDRESS, e uma impressão digital de dispositivo numa lista de permissão de dispositivos pode ignorar a ação DUPLICATED_DEVICE_FINGERPRINT. A Didit regista, ainda assim, um aviso informativo da lista de permissão para que possa auditar o motivo pelo qual a ação de duplicação não foi executada.

Listas de bloqueio do sistema

Cada aplicação recebe automaticamente 10 listas de bloqueio do sistema (uma por cada tipo de entrada suportado) e uma lista do sistema High Risk Countries. Estas listas não podem ser eliminadas nem renomeadas. Pode adicionar entradas através da API ou a partir da consola.

Rastreabilidade

Cada entrada de uma lista de bloqueio pode ser ligada à entidade de origem, para que possa navegar da lista até ao registo original:

A partir de uma sessão: passe reference_session_id ao criar uma entrada. A Didit extrai automaticamente o valor (face, documento, telefone, e-mail, IP ou dispositivo), marca o modelo subjacente como incluído numa lista de bloqueio e liga a entrada à sessão. A Didit lê o registo mais recente da sessão desse tipo; para adicionar à lista um valor de um registo anterior, adicione-o pelo value sem reference_session_id.
A partir de uma transação, utilizador ou empresa: passe reference_object_uuid com o UUID da entidade e inclua metadata.reference_type ("transaction", "vendor_user" ou "vendor_business") para que a consola possa ligar ao registo original.

Endpoints

Listar todas as listas

Obtenha todas as listas de uma aplicação.

Entradas da lista

Obtenha as entradas de uma lista.

Criar entrada

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

Eliminar entrada

Remova uma entrada e desbloqueie a entidade subjacente.

Carregar face

Carregue uma imagem facial diretamente para uma lista de bloqueio de faces.

​Conceitos

​Tipos de entrada

​Listas de permissão

​Listas de bloqueio do sistema

​Rastreabilidade

​Endpoints