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 à la Banque de Savoie 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/payment-requests.

Le cas d'usage « 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ée 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
POST /payment-requests 
GET /payment-requests/{paymentRequestResourceId}
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.
Toutes 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.
Roadmap 18 septembre 2019

Documentation portail :

  • Roadmap modifiée pour la sandbox et le live.
Eligibilité 1er octobre 2019

Documentation portail :

  • Ajout de précisions sur les certificats QWAC et QSEALC nécessaires pour une demande de goLive.
Initier un paiement 19 novembre 2019

Documentation portail:

  • Ajout de la précision "Pour les Banques de Savoie, la donnée requestedExecutionDate ne peut pas être un week-end ou un jour target 2 pour les SCT"
Comment utiliser le fallback 21 novembre 2019

Documentation portail :

  • Ajout d'un exemple
Récupérer le statut d'une initiation de paiement 9 décembre 2019

Documentation portail :

  • Ajout d'un tableau qui reprend les valeurs possibles pour le statut de l'initiation de paiement et de la transaction de paiement associée.
Tester 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)
Initier un paiement 24 décembre 2019 Activation de la prise en compte de l'IBAN transmis dans le champ debtorAccount => IBAN du PSU : lorsqu'il est renseigné, le seul compte sélectionnable pour le PSU est celui qui correspond à cet IBAN.
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.
Limitations / Historique des versions / roadmap 25 février 2020

Activation de l'API pour les autres BP que BPGO.

Modification du versionning de l'API.

Annuler une initiation de paiement / sandbox / limitations 10 septembre 2020 Activation de la méthode d’annulation d’une initiation de paiement.
POST /payment-requests 2 décembre 2020 Documentation portail :
  • Ajout de précisions sur le déclenchement des deux parcours fluides lors d'une initiation de paiement PISP
Initier un paiement / Récupérer le statut d'une initiation de paiement / Sandbox / Roadmap 22 décembre 2020

Depuis le 7 décembre :

  • Activation du parcours PISP fluide ;
  • Rejet des virements avec categoryPurpose = « CASH » lorsque l’AF ne se fait pas avec Sécur’Pass alors que le bénéficiaire n’est pas connu.
    • Si le PSU ne fait aucune action de consentement (validation ou refus) dans les 30 minutes qui suivent la requête d’initiation RJCT (raison NOAS).
Toutes 4 janvier 2021

Documentation portail :

  • Passage de la documentation de l’API DSP2 STET de la version v1 à la version v1.4.2
Toutes 19 juillet 2021

Documentation portail :

  • Activation des initiations de paiement pour les SCT permanents. NB : les annulations des initiations de paiement des SCT permanents ne devraient être disponibles qu’en septembre 2021
  • Le champ chargeBearer est facultatif pour les virements en euros.
    • 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 via l’API register.
Initier un paiement 22 juillet 2021

Documentation portail :

  • Ajout de la précision sur la limitation de la taille de la donnée beneficiary.creditor.name qui est limitée 35 caractères.
Sandbox / Try-IT 23 septembre 2021

Documentation portail :

  • Ajout de précisions sur la méthode /o-confirmation qui n'est pas disponible en sandbox.
  • Correction des exemples pour la v1.4.2.
    • Suppression de l'écran de confirmation du virement côté ASPSP (écran équivalent à proposer par le TPP après le /o-confirmation)
Initier un paiement 27 septembre 2021

Documentation portail :

  • Ajout de précisions sur le format de l'IBAN et de la donnée debtor.privateId.identification