API Listes : listes de blocage et d'autorisation

L’API Lists vous permet de gérer des listes typées pour votre application. Les listes de blocage du système sont créées automatiquement et consultées pendant la vérification et le filtrage des transactions. Vous pouvez aussi créer des listes d’autorisation et des listes personnalisées pour les conditions de workflow.

Concepts

Type	Description
Liste de blocage	Créée par le système, une par type d’entrée. Les éléments d’une liste de blocage entraînent un refus automatique pendant la vérification ou le filtrage des transactions.
Liste d’autorisation	Créée par l’utilisateur. Utilisée dans les conditions de workflow et pour supprimer les actions liées aux doublons et à la réutilisation pour les éléments correspondants fiables.
Personnalisé	Créée par l’utilisateur. Listes flexibles pour l’embranchement des workflows, les règles de surveillance ou l’examen manuel.

Types d’entrées

Type d’entrée	Vérifié pendant	En cas de correspondance
`face`	Vérification du vivant	Session refusée
`document`	Vérification d’identité (OCR)	Session refusée
`phone`	Vérification du téléphone	Session refusée
`email`	Vérification de l’e-mail	Session refusée
`ip_address`	Analyse de l’appareil et de l’IP (prend en charge les plages CIDR)	Session refusée
`device_fingerprint`	Analyse de l’appareil et de l’IP	Session refusée
`wallet_address`	Filtrage des transactions	Transaction refusée
`bank_account`	Filtrage des transactions	Transaction refusée
`user`	Filtrage des transactions	Utilisateur bloqué
`business`	Filtrage des transactions	Entreprise bloquée
`country`	Conditions de workflow	Configurable
`key`	Usage personnalisé	Configurable

Listes d’autorisation

Les listes d’autorisation ne remplacent pas les listes de blocage ni les contrôles d’authenticité. Elles suppriment uniquement les actions de doublon et de réutilisation pour le même type d’entrée. Par exemple, un visage présent dans une liste d’autorisation de visages peut éviter le déclenchement de l’action DUPLICATED_FACE, une adresse IP présente dans une liste d’autorisation d’IP peut éviter le déclenchement de l’action DUPLICATED_IP_ADDRESS, et une empreinte d’appareil présente dans une liste d’autorisation d’appareils peut éviter le déclenchement de l’action DUPLICATED_DEVICE_FINGERPRINT. Didit enregistre tout de même un avertissement informatif de liste d’autorisation afin que vous puissiez vérifier pourquoi l’action de doublon n’a pas été exécutée.

Listes de blocage système

Chaque application reçoit automatiquement 10 listes de blocage système (une par type d’entrée pris en charge) ainsi qu’une liste système High Risk Countries. Elles ne peuvent être ni supprimées ni renommées. Vous pouvez y ajouter des entrées via l’API ou depuis la console.

Traçabilité

Chaque entrée d’une liste de blocage peut être reliée à l’entité source, afin que vous puissiez passer de la liste à l’enregistrement d’origine :

Depuis une session : transmettez reference_session_id lors de la création d’une entrée. Didit extrait automatiquement la valeur (visage, document, téléphone, e-mail, IP ou appareil), marque le modèle sous-jacent comme étant sur liste de blocage et relie l’entrée à la session. Didit lit l’enregistrement le plus récent de la session pour ce type ; pour inscrire une valeur provenant d’un enregistrement antérieur, ajoutez-la par value sans reference_session_id.
Depuis une transaction, un utilisateur ou une entreprise : transmettez reference_object_uuid avec l’UUID de l’entité et incluez metadata.reference_type ("transaction", "vendor_user" ou "vendor_business") afin que la console puisse renvoyer vers l’enregistrement d’origine.

Endpoints

Lister toutes les listes

Récupérer toutes les listes d’une application.

Lister les entrées

Récupérer les entrées d’une liste.

Créer une entrée

Ajouter une valeur à une liste de blocage : par valeur, référence de session ou référence de transaction.

Supprimer une entrée

Supprimer une entrée et débloquer l’entité sous-jacente.

Importer un visage

Importer directement une image de visage dans une liste de blocage de visages.

​Concepts

​Types d’entrées

​Listes d’autorisation

​Listes de blocage système

​Traçabilité

​Endpoints