Obtenir l'identité du client
➤ Cas d'usage
Ce service permet de récupérer l’identité d'un client qui vous a donné son consentement pour le faire.
➤ Prérequis
Pour procéder à cette requête il est nécessaire de remplir les prérequis d’éligibilité et d'avoir récupéré le jeton d'accès OAUTH2 (voir la rubrique "Vue d'ensemble" > "Récupérer votre jeton").
Pour récupérer l'identité d'un PSU :
L'autorisation de transmettre au TPP ces informations d’identité doit nous avoir été transmis via la valorisation à true de l’attribut "psuIdentity" de la méthode PUT /consents et ne doit pas avoir été révoqué depuis (c’est à dire pas d'annule et remplace via PUT /consents avec un attribut "psuIdentity" valorisé à false)
L'URI pour l'accès à cette méthode est donnée via la rubrique "_links": {"endUserIdentity": {"href": ...}} en résultat de la requête GET /accounts.
➤ Requête
GET /end-user-identity
Voir aussi la spécification de place STET V1.4.2.17 / Part II / section 4.6.4 / page 43
➤ Paramètres obligatoires ou facultatifs du body requis pour l'appel de ce service
Paramètres obligatoires : PSU-IP-ADDRESS => à alimenter si le PSU est connecté.
➤ Résultat retourné
Cet appel permet de récupérer l'identité du client final.
Un lien self sera également pour revenir à la page obtenue après exécution de la requête.
Vos accès à cette méthode sont limités à 4 accès batch maximum par jour calendaire, pour un client. En revanche, lorsque c'est le client connecté qui interroge directement ses comptes à vue, le nombre d'accès n'est pas limité.
➤ Exemple
Requête
GET /stet/psd2/v1.4.2/end-user-identity
Un exemple plus complet de requête est fourni dans la rubrique "Comment tester l'API ?" > "Assemblage sandbox".
Voir aussi la spécification de place STET V1.4.2.17 / Part III / Section 6.3 / page 8