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 aux Banques Populaires décrites dans la section "Limitations". Elle tient compte des limitations fonctionnelles propres aux Banques Populaires.

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.

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

 

➤ Description du 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.

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/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, la v1.4.2 correspond à la version v1.4.2.17 des spécifications STET et la v1.6.2 correspond à la version v1.4.6.0 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
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
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 Populaires, 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. 
Toutes 22 mars 2022

Documentation portail :

  • Activation des initiations de paiement pour les SEPA Instant Payments;
  • Correction du double « s » dans « ressourceId » et « paymentRequestResourceId »:
  • Ajout de précisions sur le parapheur pour la Banque Palatine;
    • Mise à disposition du PUT /paymentRequests et du POST /paymentRequests/o-confirmation en sandbox;
  • Ajout de précisions sur le PUT /paymentRequests pour la valorisation des données transactionStatus (= »CANC »), paymentInformationStatus et statusReasonInformation ;
  • Activation des annulations pour les virements permanents.
Initier un paiement / limitations 20 avril 2022

Documentation portail :

  • Ajout de précisions pour les SEPA Instant Payments pour le B2B : les comptes et pays éligibles sont définis sur le contrat de flux IP B2B.
    • Ajout de la précision suivante : un virement initié via l'API d'initiation de paiement, ne peut être annulé par le PSU via son accès direct.
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 => activation de la v1.6.2 en sandbox le 20 octobre 2022 et en live en janvier 2023. La méthode « o-confirmation » n’est plus supportée => renommée en « confirmation »
  • Ajout des règles pour un virement multiple qui sera disponible en février 2023.
  • Ajout du categoryPurpose = « SALA » : règles alignées sur celles du categoryPurpose = « CASH »
    • La règle suivante : « La donnée requestedExecutionDate ne peut pas être un week-end ou un jour target 2 pour les SCT. Sinon, une erreur est générée et le paiement est rejeté. Cette limitation ne s'applique pas pour les SCT immédiats uniquement si requestedExecutionDate est le jour même de la demande ; dans ce cas, le paiement sera transformé en un SCT différé programmé pour le jour ouvré suivant. » devient « La donnée requestedExecutionDate peut être un week-end ou un jour target 2 pour les SCT : si requestedExecutionDate est le jour même de la demande ; dans ce cas, le paiement sera transformé en un SCT différé programmé pour le jour ouvré suivant. »
Confirmation / Limitations 21 mars 2023

Documentation portail :

  • Restitution du détail des messages d'erreur 500 (Internal Server Error) ajouté en retour de la confirmation d'un paiement.
    • Les clients de la banque BCP auront accès à l'API d'initiation de paiement 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.