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.4.2.17, 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.4.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 et la v1.4.2 correspond à la version V1.4.2.17 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

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