Obtenir la liste des comptes
Ce service permet :
- de lister tous les comptes éligibles*
- de récupérer les soldes des comptes
- de récupérer les URI pour les méthodes GET /accounts/balances et GET /accounts/transactions
- de récupérer l'URI pour la méthode GET /end-user-identity
* : comptes de paiements actifs et accessibles en ligne, soit des comptes de dépôt pour les clients particuliers, et des comptes courants pour les professionnels et entreprises.
➤ 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").
➤ Requête
Requête "GET /accounts"
Voir aussi la spécification de place STET V1.4.2.17 / Part II / section 4.2 / page 27
➤ Paramètres obligatoires ou facultatifs du body requis pour l'appel de ce service
Aucun paramètre spécifique n'est requis pour l'appel de ce service.
➤ Résultat retourné
En cas de première utilisation de cette requête (et donc si vous n'avez pas transmis au préalable d'information via la méthode PUT /consents), ou que tous les comptes consentis ont été révoqués suite au dernier appel à la méthode PUT /consents :
- Cet appel vous permet de récupérer la liste de tous les comptes de notre client sans leurs soldes, sans les URI pour les méthodes GET /accounts/balances, GET /accounts/transactions et GET /end-user-identity
Si vous avez transmis au préalable au moins un compte consenti par notre client via la méthode PUT /consents, et que tous les comptes consentis n'ont pas été révoqués suite au dernier appel à la méthode PUT /consents, alors :
- Cet appel vous permet de récupérer la liste de tous les comptes consentis du client détenteur avec :
- Leurs soldes si le compte fait parti de la liste "balances" transmise via la méthode PUT /consents
- L'URI pour la méthode GET /accounts/balances si le compte fait parti de la liste "balances" transmise via la méthode PUT /consents
- L'URI pour la méthode GET /accounts/transactions si le compte fait parti de la liste "transactions" transmise via la méthode PUT /consents
- L'URI pour la méthode GET /accounts/end-user-identity si la rubrique "psuIdentity" a été alimentée avec la valeur TRUE via la méthode PUT /consents
- Cet appel ne vous permet pas de récupérer les informations pour les comptes non consentis ou non éligibles.
Un lien self sera également présent pour revenir à la page obtenue juste après exécution de la requête.
Vos accès à cette méthode sont limités à 4 accès batch maximum par jour, pour un client donné. En revanche, le nombre d'accès n'est pas limité lorsque c'est le client connecté qui interroge directement ses comptes.
➤ Exemple
Un exemple de requête est fourni dans la rubrique "Comment tester l'API ?" > "Assemblage sandbox".
Les jeux de données de tests sont décrits dans la rubrique "Comment tester l'API ?" > "Tester nos personas".
Remarque :
- Le champ "currency" a été déplacé au niveau de l'"accountId".
Voir aussi la spécification de place STET V1.4.0.47 / Part III / section 5.1 / page 5
➤ Tests d'acceptance
Ces cas de tests ont pour objectif de vous permettre d'effectuer un minimum de tests afin de prendre en main cette API et d'y accéder depuis votre application.
Ils devront être validés avant tout déploiement applicatif en production.
Le scope OAuth2 = aisp sauf indication contraire.
Description du test | Jeu de données et Résultat attendu |
---|---|
Récupération de toutes les transactions d'un PSU Sur un compte autorisé | Persona : GEORGES Résultat : historique des transactions retourné |
Récupération des transactions sur un compte non authorisé (ou inconnu) d'un PSU | Persona : LEA Résultat : HTTP code 404 - AccountId inconnu |
Requête HTTP avec un jeton d'accès non autorisé pour la ressource (scope erroné) | Persona : LEA Prérequis : scope OAuth2 <> aisp Résultat : message d'erreur HTTP code 403 => accès à la ressource refusé |
Passage d'une mauvaise requête HTTP POST | Persona : LEA Résultat : message d'erreur HTTP code 405 => méthode non autorisée |
Récupération des transactions avec le paramètre "dateFrom" | Persona : GEORGES Résultat : historique des transactions retourné à partir de la date spécifiée en paramètre d'entrée |
Récupération des transactions avec le paramètre "dateTo" | Persona : GEORGES Résultat : historique des transactions retourné jusqu'à la date spécifiée en paramètre d'entrée |
Récupération des transactions avec les paramètres "dateFrom" et "dateTo" | Persona : GEORGES Résultat : historique des transactions retourné entre les dates spécifiées en paramètres d'entrée |
Récupération des transactions avec le champ optionnel "entryReference" vide | Persona : GEORGES Résultat : historique des transactions retourné avec le champs spécifié vide |
Récupération des transactions avec le paramètre d'entrée "dateFrom" supérieur à 62 jours | Persona : LEA Résultat : message d'erreur HTTP code 400 |
Pas de transactions disponible | Persona : CLAIRE / account FR7617515900000400358074026 Resultat : message HTTP code 204 |