API Vérification et risque des transactions

Avec une clé API de la plateforme, lancez depuis vos propres systèmes la vérification de particuliers (KYC), la vérification d’entreprises (KYB), la surveillance des transactions et l’analyse d’adresses de portefeuille, et consultez les enregistrements de contrôle. L’API ouverte et la console suivent le même processus de contrôle : mêmes tarifs, mêmes règles pour les résultats, les remboursements et le rapprochement.

Cliquez d’abord sur « Activer » dans « Vérification et risque des transactions » de la console, puis créez une clé dans « Gestion des API » en cochant les autorisations « Vérification et risque » : verification.read pour consulter les tarifs et les enregistrements, verification.write pour lancer des contrôles. Chaque contrôle lancé est débité à l’unité sur le solde du compte.

Points d’accès

• GET /api/v1/verification/info : Indique si le service est activé sur votre compte, si chacun des quatre types de contrôle est disponible et à quel tarif (USD), ainsi que les réseaux et actifs proposés pour la surveillance des transactions et l’analyse de portefeuille. Les types non disponibles n’ont pas de tarif.
• POST /api/v1/verification/checks : Lance un contrôle ; la facturation et la création de l’enregistrement ont lieu dans la même requête. Les vérifications d’identité renvoient un lien handoff_url à transmettre à la personne concernée ; la surveillance des transactions et l’analyse de portefeuille renvoient généralement le résultat directement.
• GET /api/v1/verification/checks : La liste est triée par date de lancement, du plus récent au plus ancien, filtrable par kind, status, verdict et keyword (référence / adresse / n° de facturation), et paginée avec page et page_size (100 entrées maximum par page). La consultation d’un enregistrement inclut handoff_url tant que la session est encore entre les mains de la personne concernée. L’actualisation relit le résultat auprès du fournisseur (l’analyse de portefeuille ne peut pas être actualisée : une nouvelle analyse est de nouveau facturée).

Une nouvelle tentative avec le même idempotency_key et le même contenu renvoie l’enregistrement initial, sans nouvelle facturation ; une même clé réutilisée avec un contenu différent est refusée (400). Relancer une vérification d’identité pour une référence dont la session n’est pas terminée renvoie cette session (reused vaut true), là encore sans facturation.

Callback de résultat

Renseignez une URL de callback https dans « Paramètres d’intégration » de la console et activez-la. Lorsque l’état ou le résultat d’un enregistrement de contrôle change de façon asynchrone (vérification d’identité terminée, résultat modifié par un examen manuel, résultat de transaction mis à jour, échec et remboursement), la plateforme envoie un événement en POST. L’appel de lancement que vous avez effectué n’est pas notifié : sa réponse synchrone contient déjà le résultat.

L’en-tête X-Tovanix-Event indique le type d’événement (check.updated, ou ping pour les tests), X-Tovanix-Delivery contient l’event_id, X-Tovanix-Timestamp est exprimé en secondes Unix, et X-Tovanix-Signature vaut sha256= suivi de HMAC-SHA256(secret de signature, horodatage + "." + corps brut de la requête) en hexadécimal.

Une réponse 2xx vaut livraison réussie ; dans tous les autres cas (délais dépassés compris), les nouvelles tentatives suivent un intervalle croissant de 1 minute, 5 minutes, 15 minutes, 1 heure, 3 heures, 6 heures et 12 heures, avec 8 envois au maximum, puis s’arrêtent. Chaque nouvelle tentative envoie le même event_id et le même corps d’événement : dédupliquez par event_id. Les événements peuvent arriver dans le désordre : retenez celui dont data.updated_at est le plus récent, ou appelez le point d’accès de consultation à réception pour obtenir l’état le plus récent. Une fois le callback désactivé, les événements non encore livrés ne sont plus envoyés.

Pages connexes: Vérification et risque des transactions · Vérification d’identité : particuliers et entreprises · Analyse des transactions : surveillance et analyse de portefeuilles · Documentation API