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 à la Banque Palatine 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éponse 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.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 / Methode(s)Date d'effetDescription de l'évolution
Toute la documentation de l'API STET Information sur compte 11 août 2020

Documentation portail :

  • Initiation de la documentation de l'API DSP2 STET de la version v1.4.2
Toute la documentation de l'API STET Information sur compte 19 juillet 2021

Documentation portail :

  • Mise à niveau de la documentation et activation effective de l'API.
  • 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.
Fallback 29 septembre 2021

Rajout de la donnée optionnelle "bankTransactionCode" 

  • Précision de l'impact de la nouvelle solution de banque en ligne
GET /balances 6 mars 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.