Obtenir le résultat d'un contrôle ORIAS

Si vous souhaitez obtenir le résultat de contrôle d’une personne ORIAS et exploiter ce résultat, voici les étapes à suivre.

Prérequis

Être configuré avec une source de donnée KYC
Connaître le nom technique de la source KYC à utiliser
Avoir un compte avec un token API

Déroulement

Contrôler une personne morale

Afin de récupérer le contrôle ORIAS d’une personne morale, il faut importer et contrôler la personne. Pour cela vous pouvez utiliser l’un des endpoints suivants, en fonction des données que vous avez sur vos personnes morales :

Assurez-vous de bien transmettre le numéro ORIAS dans le corps de votre appel.

Si l’appel se passe correctement, vous recevez une première réponse synchrone reprenant les éléments envoyés qui ont pu être intégrés. Puis une réponse asynchrone dans lesquels vous recevez les résultats de contrôle.

Récupérer les données dans le retour asynchrone

Les endpoints cité ci-dessus fonctionnent avec un webhook asynchrone qui renvoie les informations de contrôle quelques secondes après.

Dans cette réponse, vous pourrez identifier un bloc "OriasControl" dans lequel vous trouverez toutes les informations.

Contrôle effectué et ORIAS valide

JSON

"OriasControl": {
            "controlType": "OriasControl",
            "date": "2024-06-19T12:09:23.156Z",
            "score": 0,
            "oriasRegistration": {
              "number": "22000018",
              "status": "REGISTERED",
              "dateChecked": "2024-06-19T12:09:23.156Z"
          }

Contrôle effectué et ORIAS invalide

JSON

"OriasControl": {
            "controlType": "OriasControl",
            "date": "2024-06-19T12:09:23.156Z",
            "score": 100,
            "oriasRegistration": {
              "number": "22000018",
              "status": "UNREGISTERED",
              "dateChecked": "2024-06-19T12:09:23.156Z"
          }

Numéro ORIAS manquant ou non contrôlé

JSON

"OriasControl": {
            "controlType": "OriasControl",
            "date": "2024-06-19T12:09:23.156Z",
            "score": 0,
            "status": "null"
          }