Version History

ligne89C3

Version of the STET standard used for the API

This REST-based API is compliant with the STET specifications developed by the French market initiative (https://www.stet.eu/en/psd2/) in order to comply with PSD2 regulatory requirements. It takes into account functional limitations specific to this retail bank network (see use case "Limitations").

history

As a reminder : 

In France, the ordinance n° 2017-1252 of August 9, 2017 implements the PSD2 directive into the regulatory section of the monetary and financial code. This ordinance has been supplemented by two decrees (n° 2017-1313 and n° 2017-1314 on August 31, 2017), and five orders that were published on August 31, 2017

You can consult the virtual assistant about the STET standard.

 

Description of user support + duration of support

In accordance with article 30 (5) of the RTS, assistance for third party PSP providers is made available. This user support is accessible via the form on this portal 89C3 API, or via https://www.api.89c3.com/fr/nous-contacter. Answers are made during working hours.

Users can also consult the virtual assistant by clicking on the pictogram Assistant virtuelon the portal home page.


In order to query an API, the API version includes the version number in the called URI, for example :  /stet/psd2/v1/accounts.

« Roadmap » use case gives the correspondence table between the version of the API and the version of the specification used, ie for example the API v1 corresponds to the version V1.4.0.47 of the STET specifications.

The principle of the duration of support is shown below by taking into account article 30 (4) of the RTS:

Support portail VE

API versioning:

Our API version STET standard version
v1 v1.4.0.47

You can consult the virtual assistant about the STET standard.

 

Important changes made since the first version delivered :

Use case(s) / Method(s) Effective date Description of the evolution
GET/transactions May 02, 2019 Changing the format of the "remittanceInformation" field :
     Former format : String
     New format : [String]
Portal documentation : updating examples.
GET/accounts
GET/transactions
May 02, 2019 Changing the naming of the field "resourceId" :
     Former name: ressourceId
     New name: resourceId
Portal documentation : updating examples.
GET/accounts
GET/transactions
GET/balances
PUT/consent
May 17, 2019 Portal documentation : addition of clarification about the mandatory or optional nature of parameters and fields of requests.
GET/transactions May 17, 2019 Refresh test data (personas): depth of history over 3 months
Portal documentation : updating examples.
GET/transactions May 29, 2019 Correction of the return rule of the list of transactions when the parameter "afterEntryReference" is entered : the transaction corresponding to the parameter "afterEntryReference" filled in is not part of the returned list, only transactions having a technical identification greater than this value are included within the result.
Authentication and OAUTH2 access token June 21, 2019 Portal documentation: correction of links and parameters in the description of the OAUTH2 access token recovery sequence.
    the 'redirect_url' parameter has been changed to 'redirect_uri'
    in the GET request, the 'response_tye' parameter has been replaced by 'response_type'.
All August 8, 2019

Portal documentation :

  • description of the target sandbox assembly at the end of August 2019;
  • additions of details (limitations, samples, date of availability, etc.) for all use cases.
Roadmap September 18, 2019

Portal documentation :

  • Roadmap modified for sandbox and live.
Eligibility October 1, 2019

Portal documentation :

  • Precisions added on "eligibility" use case about QWAC and QSEALC certificats needed to give access to goLive.
All October 29, 2019 Portail documentation:
 
  • Roadmap modified : GET /trustedBeneficiaries postpone to 2020
  • Sanbox assembly : translation of the French version of the use case 
Sandbox assembly / How to retrieve the OAUTH2 access token November 13, 2019

Portal documentation:

  • redirect_URI made mandatory for the GET / authorize and must be identical and filled for the POST / token
How to use the fallback mode? Novembre 21, 2019

Portal documentation :

  • Example added
Test data December 23, 2019

Portal documentation

  • Following clarification added in the use case "THESE PSU ID & TEST DATA CANNOT BE USED IN PRODUCTION LIVE ENVIRONMENT" 
  • Modification of persona's remote banking identifiers => these new identifiers are active since January 8, 2020 (the old identifiers are deactivated)
Get transactions history December 24, 2019

Portal documentation :

  • "SARL UNIPERSONNELLE 2640" test case added to retrieve 4500 transactions for the 5 accounts and 1 delayed debit card. 73 different typologies / operation codes are returned
Version history / roadmap December 30, 2019

Portal documentation :

  • Addition of details on the management of API versioning and decommissioning.
Version history / roadmap March 31, 2020 Modification of API versioning for the "Get trusted beneficiairies list" and "Get PSU's identity" functionalities