Obtenez les soldes d'un compte à vue ou les encours des cartes à débit différé adossées à ce dernier !

➤ Cas d'usage

Ce service permet de récupérer la liste des soldes d'un compte à vue ou les encours d'une carte à débit différé du client.

Ce service fait suite à la restitution de la liste des comptes et cartes d'un client : un resourceId correspondant à un compte ou une carte doit être fourni pour obtenir la liste des soldes ou encours.

3 types de soldes seront retournés dans le cas d'un compte passé en paramètre :

• Solde en valeur ("VALU" dans la norme STET) => solde affiché par rapport à une date de valeur
• Solde Comptable ("CLBD" dans la norme STET) => solde comptable en fin de période (fin de semaine, fin de mois, fin de trimestre, fin de semestre, fin d’année)
• Solde TP ("OTHR" dans la norme STET) => solde instantané (évolue en temps réel à chaque écriture sur le compte)

3 types d'encours seront retournés dans le cas d'une carte passée en paramètre :

• Encours => montant des facturettes reportées au mois suivant
• Encours terminé non prélevé => correspond au montant des facturettes du mois courant non encore comptabilisées
• Encours terminé prélevé => correspond au montant des facturettes du mois précédent

Une pagination de la liste renvoyée peut être faite s'il y a beaucoup de données à afficher, dans ce cas des liens donnant accès à la première page, la précédente, la suivante et la dernière page faciliteront la consultation des résultats.

Les accès à cette méthode sont limités à 4 accès batch maximum par jour calendaire, pour un client et pour un compte / une carte à débit différé donnés.

En résumé, ce service permet de lister les soldes d'un compte à vue du client ou de lister les encours d'une carte à débit différé adossée à ce compte à vue.

➤ 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 le solde d'un compte à vue :

• L'IBAN du compte doit nous avoir été transmis dans la liste "balances" de la méthode PUT /consents et ne doit pas avoir été révoqué depuis (<=> pas d'annule et remplace via PUT /consents sans cet IBAN dans la liste "transactions")

• L'"accountResourceId" permettant d'interroger cette méthode pour ce compte courant, est récupéré via le résultat de la requête GET /accounts dans la rubrique "resourceId" pour le compte à vue correspondant à cet IBAN, c'est-à-dire tel que "accountId": {"iban":"" }

• L'URI pour l'accès à cette méthode est donnée via la rubrique "_links": {"balances":"{"href": ...}} en résultat de la requête GET /accounts pour le "resourceId" du compte à vue

Pour récupérer les encours d'une carte à débit différé adossée à un compte à vue :

• L'IBAN du compte à vue auquel est adossée la carte à débit différé doit nous avoir été transmis dans la liste "balances" de la méthode PUT /consents et ne doit pas avoir été révoqué depuis (<=> pas d'annule et remplace via PUT /consents sans cet IBAN dans la liste "transactions")

• L'"accountResourceId" permettant d'interroger cette méthode pour la carte à débit différé, est récupéré via le résultat de la requête GET /accounts dans la rubrique "resourceId" pour la carte à débit différé, c'est à dire :
  tel que "accountId": {"other":"{"schemeName": CPAN}} avec "linkedAccount" qui correspond au "resourceId" du compte à vue
  avec le "resourceId" du compte à vue récupéré via la requête GET /accounts et tel que "accountId": {"iban":"" }

• L'URI pour l'accès à cette méthode est donnée via la rubrique "_links": {"balances":"{"href": ...}} en résultat de la requête GET /accounts pour le "resourceId" de la carte à débit différé.

➤ Requête

Requête "GET /accounts/{accountResourceId}/balances"

 Voir aussi la spécification de place STET V1.4.2.17 / Part II / Section 4.3.4 / page 31 

➤ Paramètres obligatoires ou facultatifs du body requis pour l'appel de ce service

Paramètre accountResourceId : compte à vue pour lequel on veut consulter les soldes ou carte à débit différé pour laquelle on veut consulter les encours, cette donnée correspond à la rubrique "resourceId" obtenue dans la page de résultat de la requête GET /accounts.

Paramètre facultatif : PSU-IP-ADDRESS => à alimenter si le PSU est connecté.

➤ Résultat retourné

Cet appel permet de récupérer :

• la liste des soldes pour le compte à vue passé en paramètre
• ou la liste des encours de la carte à débit différé passée en paramètre.

3 types de soldes seront retournés dans le cas d'un compte à vue passé en paramètre :

3 types d'encours pourront être retournés dans le cas d'une carte passée en paramètre :

Un lien self sera également présent 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 et pour un compte à vue ou une carte à débit différé donnés (modulo la pagination éventuelle). 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/accounts/038-CPT30019654051/balances"

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".

 Voir aussi la spécification de place STET V1.4.2.17 / Part III / Section 6.4 / page 9 

Résultat

Status code : 200

Body

(cas du persona Marc - D0999990I0)

Codes erreurs

Voici la liste de descriptions des codes erreurs de ce service. Il y a une annotation rouge pour ceux étant définis CFONB.

Lien vers la description de la méthode et des codes retour http

➤ Test 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.