Obtenir le découvert autorisé 

Ce service permet de récuperer le découvert autorisé d'un compte de paiement d'un client qui a donné son consentement au TPP pour pouvoir y accéder.

Ce type de compte est soit un compte de dépôt pour les particuliers, soit un compte courant pour les professionnels et les personnes morales. 

 

➤ Prérequis

Ce service fait suite à la restitution de la liste des comptes d'un client : un identifiant de ressource correspondant à un compte doit être fourni pour obtenir le découvert autorisé.

Pour récupérer le découvert autorisé d'un compte :

  • 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 "overdrafts")

  • 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 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": {"overdrafts":"{"href": ...}} en résultat de la requête GET /accounts pour le "resourceId" du compte

 

➤ Requête

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

book picto Voir aussi la spécification de place STET 



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

Paramètre obligatoire : accountResourceId (compte pour lequel le découvert doit être retourné).

Cette donnée correspond à la rubrique "resourceId" obtenue dans la page de résultat de la requête GET /accounts.

Les accès à cette méthode sont limités à 4 accès batch maximum / jour / TPP / IBAN / ASPSP / PSU donnés.

En revanche, lorsque c'est notre client connecté qui interroge directement ses comptes via un TPP, le nombre d'accès n'est pas limité.

 

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

book picto Voir aussi la spécification de place STET