Blocklist e allowlist API: Lists API di Didit

L’API Lists ti permette di gestire liste tipizzate per la tua applicazione. Le blocklist di sistema vengono create automaticamente e controllate durante la verifica e lo screening delle transazioni. Puoi anche creare allowlist e liste personalizzate da usare nelle condizioni del workflow.

Concetti

Tipo	Descrizione
Blocklist	Creata dal sistema, una per tipo di voce. Gli elementi presenti in una blocklist causano un rifiuto automatico durante la verifica o lo screening delle transazioni.
Allowlist	Creata dall’utente. Usata nelle condizioni del workflow e per sopprimere le azioni di duplicato/riutilizzo per gli elementi corrispondenti attendibili.
Personalizzata	Creata dall’utente. Liste flessibili per la diramazione del workflow, le regole di monitoraggio o la revisione manuale.

Tipi di voce

Tipo di voce	Controllato durante	In caso di corrispondenza
`face`	Verifica della vitalità	Sessione rifiutata
`document`	Verifica dell’identità (OCR)	Sessione rifiutata
`phone`	Verifica telefonica	Sessione rifiutata
`email`	Verifica email	Sessione rifiutata
`ip_address`	Analisi dispositivo e IP (supporta intervalli CIDR)	Sessione rifiutata
`device_fingerprint`	Analisi dispositivo e IP	Sessione rifiutata
`wallet_address`	Screening delle transazioni	Transazione rifiutata
`bank_account`	Screening delle transazioni	Transazione rifiutata
`user`	Screening delle transazioni	Utente bloccato
`business`	Screening delle transazioni	Azienda bloccata
`country`	Condizioni del workflow	Configurabile
`key`	Uso personalizzato	Configurabile

Allowlist

Le allowlist non sovrascrivono le blocklist né i controlli di autenticità. Sopprimono soltanto le azioni di duplicato/riutilizzo per lo stesso tipo di voce. Ad esempio, un volto presente in un’allowlist di volti può saltare l’azione DUPLICATED_FACE, un IP presente in un’allowlist di IP può saltare l’azione DUPLICATED_IP_ADDRESS e un device fingerprint presente in un’allowlist di dispositivi può saltare l’azione DUPLICATED_DEVICE_FINGERPRINT. Didit registra comunque un avviso informativo dell’allowlist, così puoi verificare il motivo per cui l’azione di duplicato non è stata eseguita.

Blocklist di sistema

Ogni applicazione riceve automaticamente 10 blocklist di sistema (una per tipo di voce supportato) e una lista di sistema High Risk Countries. Non possono essere eliminate né rinominate. Puoi aggiungere voci tramite l’API o dalla console.

Tracciabilità

Ogni voce di una blocklist può essere collegata alla sua entità di origine, così puoi passare dalla lista al record originale:

Da una sessione: passa reference_session_id quando crei una voce. Didit estrae automaticamente il valore (volto, documento, telefono, email, IP o dispositivo), contrassegna il modello sottostante come presente in blocklist e collega la voce alla sessione. Didit legge il record più recente della sessione di quel tipo; per inserire un valore da un record precedente, aggiungilo tramite value senza reference_session_id.
Da una transazione, un utente o un’azienda: passa reference_object_uuid con l’UUID dell’entità e includi metadata.reference_type ("transaction", "vendor_user" o "vendor_business"), così la console può collegarsi al record originale.

Endpoint

Elenca tutte le liste

Recupera tutte le liste di un’applicazione.

Voci della lista

Recupera le voci di una lista.

Crea voce

Aggiungi un valore a una blocklist, tramite valore, riferimento di sessione o riferimento di transazione.

Elimina voce

Rimuovi una voce e sblocca l’entità sottostante.

Carica volto

Carica direttamente un’immagine del volto in una blocklist di volti.

​Concetti

​Tipi di voce

​Allowlist

​Blocklist di sistema

​Tracciabilità

​Endpoint