Get PSU's identity
➤ Introduction
This service allows you to retrieve the connected PSU's identity who has given you their consent to do so (who is not necessarely the customer having the account).
➤ Prerequisites
To proceed with this request, it is necessary to fulfill the eligibility prerequisites and to have retrieved the OAUTH2 access token (see in the section "Overview" > "Get your access token").
To get the PSU's identity, you need :
The authorization to transmit this identity information to the TPP must have been transmitted to us via the setting to true of the "psuIdentity" attribute of the PUT /consents method and must not have since been revoked (i.e. not cancel and replace via PUT /consents with a "psuIdentity" attribute set to false);
The URI to access this method is given through the "_links": {"endUserIdentity": {"href": ...}} item as a result to the GET /accounts request.
➤ Request
Method GET /end-user-identity
See also STET specifications
Mandatory or optional settings of the body required to call this service
Mandatory settings : PSU-IP-ADDRESS => to inform if the PSU is connected.
➤ Returned result
This call allows you to get the identity of the end customer
A self link will also be available to return to the page obtained after execution of the request.
This method is limited to a maximum of 4 batch calls per calendar day per TPP + ASPSP + account + PSU. However, when the customer is connected to TPP app and requests an access to his current accounts, the number of access is not limited.
➤ Example
You can find an example of this request in section "Test our API" and then "Use our sandbox".
See also STET specifications
➤ Acceptance tests
These test cases are intended to allow you to perform a minimum of tests to get started with this API and access it from your application.
Description of the test | Data |
---|---|
User identity recovery | Persona : Marc - D0999990I0 Prerequisites : scope OAuth2 = aisp Results : HTTP answer 200 => OK |
Recovery of the identity of the user who has not given their consent for this | Persona : Tech’n Co - D0999993I0 Prerequisites : scope OAuth2 = aisp Results : HTTP answer 403 => access to the ressource denied |