Lors de la création d’un dossier, il est indispensable de renseigner un ou plusieurs callback_endpoints, c’est-à-dire des URL(s) sur lesquelles ID360 enverra automatiquement des notifications (en HTTP POST) tout au long du processus d’identification.

Chaque callback_endpoint recevra un payload contenant des informations liées au dossier, notamment son statut et les étapes franchies par l’utilisateur.

Vous avez la possibilité de renseigner une ou plusieurs URLs de callback. Pour chaque callback, vous pouvez définir le niveau de notification souhaité :

• Callback finale uniquement : vous recevez une seule notification à la fin du processus, indiquant que l’identification est terminée, avec les informations associées.
• Callbacks intermédiaires + finale : vous êtes notifiés à chaque étape clé du parcours utilisateur (début, upload, validation des documents, etc.), en plus de la notification finale.

Il est important de noter que dans certains cas, des callbacks intermédiaires peuvent arriver après la callback finale. Cela peut se produire si l’envoi initial d’une callback a échoué (par exemple si votre serveur était temporairement indisponible) : ID360 effectuera alors des re-tentatives automatiques (retries) pour garantir la bonne réception.

Ces retries peuvent provoquer un désalignement temporel dans l’ordre des messages reçus.

• → Il est donc fortement recommandé de vous baser sur le contenu du payload plutôt que sur l’ordre d’arrivée des notifications.

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 statut présent dans enrollment_step peut être OK, KO, FAILED, USER_PROCESSING, SYS_PROCESSING.

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 (n+1)^3 (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", value: "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”`.