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"

book picto Voir aussi la spécification de place STET 



➤ 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/balancesGET /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".

book picto Voir aussi la spécification de place STET 



➤ 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 testJeu 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