Historique des versions

➤ Version de la norme STET utilisée pour l'API

Cette API REST est conforme à la spécification interbancaire française STET (https://www.stet.eu/en/psd2/), version v.1.6.2.0, afin de répondre aux exigences règlementaires de la DSP2. Elle tient compte des limitations fonctionnelles propres aux Banques Populaires décrites dans la section "Limitations".

dsp2

Pour rappel : 

 

En France, l’ordonnance n° 2017-1252 du 9 août 2017 transpose la directive DSP2 dans la partie législative du code monétaire et financier. L’ordonnance est complétée au plan réglementaire par les décrets n° 2017-1313 et n° 2017-1314 du 31 août 2017 et les cinq arrêtés du 31 août 2017. 

Vous pouvez aussi consulter l'assistant virtuel au sujet des spécifications STET.

 

➤ Description du support utilisateur + durée de support

Conformément à l’article 30 (5) des RTS, une assistance pour les prestataires PSP tiers est mise à disposition. Ce support utilisateur est accessible via le formulaire sur ce portail 89C3 API, ou via https://www.api.89c3.com/fr/nous-contacter. Les réponses se font pendant les heures de travail ouvrées.

Les utilisateurs peuvent également consulter l'assistant virtuel en cliquant sur le pictogramme Assistant virtuelsur la page d’accueil du portail.


Afin d’interroger une API, la version de l’API inclut le numéro de version dans l’URI appelée, soit par exemple :  /stet/psd2/v1.6.2/accounts.

La rubrique "Roadmap" donne la table de correspondance entre la version de l’API et la version de la spécification utilisée, soit par exemple :

  • la v1 de l’API correspond à la version V1.4.0.47 des spécifications STET ;
  • la v1.4.2 correspond à la version V1.4.2.17 des spécifications STET ;
  • la v1.6.2 correspond à la version V1.6.2.0 des spécifications STET.

Le principe de la durée de support est schématisé ci-dessous en prenant en compte l’article 30 (4) des RTS :

Support portail VF

 

➤ Versionning de l'API

Nos versions APIVersion norme STET
v1 v1.4.0.47
v1.4.2 v1.4.2.17
v1.6.2 v1.6.2.0

Vous pouvez consulter l'assistant virtuel au sujet des textes de la norme STET.

 

➤ Evolutions importantes apportées depuis la première version livrée

Cas d'usage / Méthode(s)Date d'effetDescription de l'évolution
GET/transactions 02 mai 2019

Changement du format du champ « remittanceInformation » :

  • Ancien format : String
  • Nouveau format : [String]
Documentation portail : mise à jour des exemples.
GET/accounts
GET/transactions
02 mai 2019

Changement du nommage du champ « resourceId » :

  • Ancien nom : ressourceId
  • Nouveau nom : resourceId
Documentation portail : mise à jour des exemples.
GET/accounts
GET/transactions
GET/balances
PUT/consent
17 mai 2019 Documentation portail : ajout de précisions sur le caractère obligatoire ou facultatif des paramètres et des champs des requêtes.
GET/transactions 17 mai 2019 Rafraichissement des données de test (personas) : profondeur d'historique sur 3 mois
Documentation portail : mise à jour des exemples.
GET/transactions 29 mai 2019 Correction de la règle de restitution de la liste des transactions lorsque le paramètre "afterEntryReference" est renseigné : la transactions correspondant au paramètre "afterEntryReference" renseigné ne fait pas partie de la liste restituée, seules les transactions ayant une identification technique supérieure à cette valeur sont incluses dans le résultat.
Authentification et jeton d'accès OAuth2 21 juin 2019 Documentation portail : correction des liens et des paramètres dans la description la séquence de récupération du jeton d'accès OAUTH2.
le paramètre 'redirect_url' a été remplacé par 'redirect_uri'
dans la requête GET le paramètre 'response_type' a été remplacé par 'response_type'
Tous 31 juillet 2019 Documentation portail : description de l'assemblage sandbox en cible à fin août 2019 : ajouts de précisions (limitations, exemples, date de mise à disposition, etc.) sur l'ensemble des cas d'usage de l'API.
Assemblage sandbox 18 septembre 2019 Documentation portail : description de l'assemblage sandbox complétée.
Roadmap modifiée pour la sandbox et le live.
Eligibilité 10 octobre 2019

Documentation portail :

  • Ajout du redirect_uri en params de la requête GET /authorize.
  • Précision sur le seul établissement (13807 / BPGO) accessible en environnement d'assemblage sandbox.
Tous 18 octobre 2019

Documentation portail :

  • "Eligibilité" : précisée
  • "Limitations" : banques accessibles en sandbox et en live
  • "Roadmap" : GET /trustedBeneficiaries repoussée en 2020
  • "Assemblage sandbox" : précisions sur les prérequis et l'alimentation de l'organizationId=client_id
Assemblage sandbox / Comment récupérer son jeton d'accès OAUTH2 13 novembre 2019

Documentation portail :

  • redirect_URI rendu obligatoire pour le GET /authorize et qui doit être identique et alimenté pour le POST /token
Comment utiliser le fallback 21 novembre 2019

Documentation portail :

  • Ajout d'un exemple
Testez nos persona 23 décembre 2019

Documentation portail :

  • Précision suivante ajoutée dans le cas d'usage "CES IDENTIFIANTS ET DONNEES DE TEST NE PEUVENT PAS ETRE UTILISES EN PRODUCTION LIVE."
  • Modification des identifiants banque à distance des persona => ces nouveaux identifiants sont actifs depuis le 8 janvier 2020 (les anciens identifiants sont désactivés)
GET /transactions 24 décembre 2019

Documentation portail :

  • Ajout du persona "SARL UNIPERSONNELLE 2640" pour récupérer 4500 transactions de 5 comptes et d'1 carte à débit différés. 73 typologies / codes opération différents sont retournés.
Historique des versions / roadmap 30 décembre 2019

Documentation portail :

  • Ajout de précisions sur la gestion du versionning et du décommissionnement des API.
Historique des versions / roadmap 31 mars 2020

Documentation portail :

  • Modification du versionning de l'API pour les fonctionnalités "Obtenir la liste des bénéficiaires de confiance d'un PSU" et "Obtenir l'identité du PSU"
Toutes 8 juillet 2020

Documentation portail :

  • Passage de la documentation de l’API DSP2 STET de la version v1 à la version v1.4.2
  • Précision sur la plage hebdomadaire de maintenance dans le cas d’usage "Limitations"
GET /transactions 12 avril 2021

Documentation portail :

  • Correction pour restituer toutes les cartes à débit différé d'un compte joint.
GET /transactions 11 mai 2021

Documentation portail :

  • Correction pour restituer les facturettes des cartes à débit différé qui ne sont pas comptabilisées avec le status = « OTHR » (et non « PDNG »).
Toutes 19 juillet 2021

Documentation portail :

  • Précision sur la gestion des clientId suivant que l'enregistrement du TPP s'est fait via le processus de "GoLive" de notre portail 89C3 API (ancienne procédure) ou via l’API register (procédure actuelle).

Fallback 

Jeton d'accès

29 septembre 2021

Documentation portail : 

  • Fallback: précision de l'impact de la nouvelle solution de banque en ligne
  • Jetons d'accès : précision sur la révocation des jetons
GET /balances 6 avril 2022

Documentation portail :

  • Ajout de précisions sur la disponibilité du solde en valeur et du solde comptable.
Vue d'ensemble 28 août 2022

Changements éditoriaux et rajout du cas App2App

Toutes 26 septembre 2022

Documentation portail :

  • Passage de la documentation de l’API DSP2 STET de la version v1.4.2 à la version v1.6.2
  • Transverse :
  • Le paramètre workspace qui a été introduit avec la norme STET v1.6.2 est ignoré s’il est renseigné pour toutes les requêtes : la notion de workspace n'existe pour les Banques Populaires, la Banque Palatine et la Banque de Savoie.
  • Méthode GET /accounts :
    • Désormais, tous les comptes seront systématiquement remontés à chaque accès via la méthode GET /accounts que le client ait donné ou non son consentement pour chacun de ses comptes. En revanche les transactions, soldes et découverts autorisés de chacun des comptes ne seront restitués qu’en fonction des consentements donnés sur le compte (règle inchangée). Cela permet notamment de récupérer les nouveaux comptes du client lorsqu’un consentement a déjà été donné pour un autre compte, sans avoir à réinitialiser l’ensemble des consentements du client.
    • Le schemeName "CPAN" est remplacé par "TPAN" afin de préciser que le numéro de carte est encodé.
    • Désormais, il est possible de récupérer les typologies de virements PISP possibles pour le compte dans la donnée details valorisée avec "features:" suivi des valeurs "IP" et/ou "SCT" et/ou "SCT_MULT".
  • Méthode GET /balances
    • Modification pour restituer les facturettes des cartes à débit différé
      • Encours ("ITAV" dans la norme STET au lieu de "OTHR" en v1.4.2) => montant des facturettes reportées au mois suivant
      • Encours terminé non prélevé ("ITAV" dans la norme STET au lieu de "OTHR" en v1.4.2) => correspond au montant des facturettes du mois courant non encore comptabilisées
      • Encours terminé prélevé ("PRCD" dans la norme STET au lieu de "OTHR" en v1.4.2) => correspond au montant des facturettes du mois précédent
      • Le montant des encours carte est rendu négatif.
  • Méthode GET /transactions
    • Seule la valeur "bookingDate" est acceptée pour le nouveau paramètre dateType de la méthode GET /transactions. C'est la valeur par défaut. Les autres valeurs font l'objet d'une erreur 400.
    • Alimentation du nouveau champ endToEndId pour les virements émis.
    • Le status "OTHR" n'existe plus.
      • Les opérations écartées passent au status = "INFO" au lieu de « OTHR » en v1.4.2.
      • Les opérations en suspens passent au status = "INFO" au lieu de « OTHR » en v1.4.2.
      • Les facturettes des cartes à débit différé qui ne sont pas comptabilisées sont au status = « FUTR » au lieu de « OTHR » en v1.4.2.
  • Méthode PUT /consents
    • Prise en compte du consentement pour la méthode « overdrafts »
    • Consentement pour la méthode « owners » ignoré, méthode non implémentée
    • Consentement pour les trustedWorkspaceBeneficiaries ignoré
  • Méthode GET /overdrafts
    • Nouvelle méthode mise en œuvre en v1.6.2 pour restituer les découverts autorisés sur les comptes à vue.
  • Méthode GET/end-user-identity
    • En v1.6.2, les propriétés ont été renommées et regroupées dans l'objet identity.
Transactions / Limitations 29 mars 2023

Documentation portail :

  • Méthode GET /transactions
    • Restitution des prélèvements à venir.
    • Les clients de la banque BCP auront accès à l'API d'information sur compte mi-juin 2023, post migration des agences BCP vers la banque BPALC avec leur IBAN Luxembourgeois : ajout du persona James pour les tests en sandbox.

Toutes

22 mai 2023

Documentation portail :

  • Augmentation du délai à 180 jours au lieu de 90 jours avant expiration du jeton Refresh Token AISP : bascule progressive entre le 24 mai et le 2 juin 2023 pour l'ensemble des TPP enrôlés.