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".
Pour rappel :
- les textes de la directive de paiement numéro 2 (DSP2, référence UE 2015/2366 du 25/11/2015) sont rentrés en application le 13 janvier 2018 : http://eur-lex.europa.eu/legal-content/FR/TXT/?uri=CELEX:32015L2366
- ils ont été complétés par les normes techniques de réglementation (NTR, règlement délégué UE 2018/389) relatives à l’authentification forte du client et à des normes ouvertes communes et sécurisées de communication dont la date d'application se situe au 14 septembre 2019. Ces normes sont les RTS (Rules Technical Standards) : https://eur-lex.europa.eu/legal-content/FR/TXT/?toc=OJ%3AL%3A2018%3A069%3ATOC&uri=uriserv%3AOJ.L_.2018.069.01.0023.01.FRA
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 
sur 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 :
➤ Versionning de l'API
| Nos versions API | Version 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'effet | Description de l'évolution |
|---|---|---|
| GET/transactions | 02 mai 2019 | Changement du format du champ « remittanceInformation » :
|
| GET/accounts GET/transactions | 02 mai 2019 | Changement du nommage du champ « resourceId » :
|
| 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 :
|
| Tous | 18 octobre 2019 | Documentation portail :
|
| Assemblage sandbox / Comment récupérer son jeton d'accès OAUTH2 | 13 novembre 2019 | Documentation portail :
|
| Comment utiliser le fallback | 21 novembre 2019 | Documentation portail :
|
| Testez nos persona | 23 décembre 2019 | Documentation portail :
|
| GET /transactions | 24 décembre 2019 | Documentation portail :
|
| Historique des versions / roadmap | 30 décembre 2019 | Documentation portail :
|
| Historique des versions / roadmap | 31 mars 2020 | Documentation portail :
|
| Toutes | 8 juillet 2020 | Documentation portail :
|
| GET /transactions | 12 avril 2021 | Documentation portail :
|
| GET /transactions | 11 mai 2021 | Documentation portail :
|
| Toutes | 19 juillet 2021 | Documentation portail :
|
Fallback Jeton d'accès | 29 septembre 2021 | Documentation portail :
|
| GET /balances | 6 avril 2022 | Documentation portail :
|
| Vue d'ensemble | 28 août 2022 | Changements éditoriaux et rajout du cas App2App |