Contrôle supplémentaire

Pour les opérations qui exigent un niveau de confiance plus élevé (ouverture d’un compte à distance, virement important, changement d’appareil), vous pouvez demander à l’utilisateur une étape de contrôle supplémentaire (« step-up ») en plus de sa confirmation habituelle.

Comment le demander

Ajoutez stepUp à l’objet requirement de votre appel à /auth ou /sign.

{
  "endUserIp": "196.28.245.10",
  "requirement": {
    "stepUp": ["document"]
  }
}

Valeur	Contrôle demandé
`document`	L’utilisateur présente sa pièce d’identité (CNIB ou carte WURI), que l’application lit et compare aux données enregistrées à l’activation.

Ce qui se passe

Pendant la demande, /collect renvoie userStepUp : l’application attend que l’utilisateur choisisse comment confirmer son identité. À la fin, completionData.stepUp indique le contrôle réalisé.

"stepUp": { "document": true }

Quand il échoue

stepUpFailed : le contrôle n’a pas abouti. Message EM25 (voir Messages utilisateur).
notSupportedByUserApp : la version de l’application ne gère pas le contrôle demandé. Demandez à l’utilisateur de mettre à jour ExcelID.

Bonnes pratiques

Ne l’exigez que quand c’est utile : chaque étape ajoute de la friction. Combinez-le avec l’indication de risque.
Expliquez à l’utilisateur pourquoi, dans votre texte (userVisibleData).