Lors de la création d'un dossier, il est essentiel de renseigner le champ “callback_url”. Cette URL de callback est appelée en mode POST par ID360, incluant un payload contenant plusieurs informations.

Les callbacks intermédiaires vous permettront d’être notifié pour chaque étape accomplie par l'utilisateur dans le cadre de son processus d'identification et vous fourniront des informations sur le bon déroulement du processus.

Enfin, la callback finale, émise à la fin du processus d'identification, vous informera de la fin du processus d’identification et vous donnera des informations sur cette dernière.

Vous avez la possibilité de choisir de recevoir des callbacks seulement en fonction du statut du dossier, ce sont les callback_endpoints.

Ci-dessous un exemple de payload (format JSON) envoyé par ID360 à votre URL de callback :

En tant que service de confiance, nous avons la responsabilité de nous conformer aux normes en vigueur, notamment l'ETSI EN 319 401, qui exige l’utilisation des versions les plus récentes de TLS pour garantir la sécurité et la fiabilité de nos échanges.

Nous vous recommandons de vérifier que votre connexion est correctement configurée en TLSv2 ou TLSv3.

Si vous souhaitez autoriser nos adresses IP, nous vous invitons à contacter votre Customer Success Manager, qui se chargera de vous les communiquer.

À chaque étape franchie par l'utilisateur, vous recevrez des notifications intermédiaires sous forme de callback, qui vous informeront de la nature et du statut de l'étape en question.

Le statut d'une callback intermédiaire sera systématiquement défini sur « STARTED ».

Le bloc steps_status indique qu’un total de 7 étapes de contrôle a été identifié pour le parcours associé à ce payload.

La valeur done = 1 signifie que seule l’étape ProfileDataStep (qui était de pousser le nom de famille par API) a été finalisée.

Le champ enrollment_step fournit des informations détaillées sur l’étape, notamment le résultat du contrôle, le type de vérification effectuée, ainsi que la liste des documents concernés.

Le type présent dans la variable enrollment_step est une information interne, à ce titre, il ne doit pas être utilisé ou exploité.

La callback finale vous signalera la fin du processus d’identification et vous donnera des informations sur cette dernière.

Le statut d’une callback finale sera : OK, KO, FAILED ou CANCELED.

Dans le cas d’un KO, comme dans l’exemple ci-contre, la raison vous informera de la cause de ce KO.

Dans le steps_status la valeur « done » sera égale à la valeur « total ».

Dans le cadre de cette callback, vous devez renvoyer un code 2XX (par exemple 204) dans un délai inférieur à 10 secondes.

Si cette réponse n’est pas reçue, jusqu’à 6 nouvelles tentatives (retries) seront effectuées selon le planning suivant :

Ces intervalles sont calculés selon la formule : 10 x 6^n (n correspondant au numéro de la tentative) — le résultat étant exprimé en secondes.

Dans le body de l'étape de la création d'un dossier utilisateur :

"callback_endpoints": [
  {
    "url": "https://votre-serveur.com/callback",
    "on": [
      "F"
    ],
    "headers": [
      {
        "name": "Authorization: Bearer abc123"
      }
    ]
  }
]

• `url` : l’adresse du endpoint à appeler (POST) lorsqu’un événement est déclenché.
• `on` : liste des événements pour lesquels ce callback sera exécuté.
• `headers` : liste de headers personnalisés à inclure dans la requête (ex : authentification, trace, etc.).

• `F` – Failed
• `C` – Canceled
• `E` – End (OK ou KO)
• `I` – Intermediate
• `UP` – Mie User Processing
• `SP` – Mie Sys Processing

• Vous pouvez définir plusieurs endpoints en les ajoutant à la liste `“callback_endpoints”`.
• Chaque callback sera déclenché uniquement pour les statuts spécifiés dans `“on”`.