Home

La Banque Postale has developed APIs in order to comply with the requirements of the delegated Commission Delegated Regulation (EU) 2018/389 of 27 November 2017 (RTS) and thus enable TPP to offer their service.

The status of La Banque Postale's API is as follows:

  • The confirmation on the availability of funds API (CBPII) is compliant.
  •  The account information API (AISP) is compliant. 
  •  The payment initiation API (PISP) is partially compliant. The most important features are available with SCT inst, SCT and standing orders. International payments will arrived later.

In view of the regulatory texts, an incomplete API cannot be considered as the nominal interface for exchange with the TPPs. Therefore, at the request of the regulator, La Banque Postale invites the TPPs to use the alternative access, i.e. the authenticated web scraping solution. The documentation of this alternative solution is available in the Support section.

 

As part of its commitment to quality, LA BANQUE POSTALE's Open-Banking team is carrying out a satisfaction survey among its TPP users to evaluate and improve its APIs service offering and the quality of its support service. 

We value your opinion. 

 

Thank you in advance for your feedback!

 

 

Features and releases

 

       Emergency Information and Incidents

25/04/2023 - Important : AISP API version 1 (STET 1.4) has been deprecated due to the release of version 2 (STET 1.6.2). As a result, we kindly request that all users migrate to v2 before December 31st, 2023, as v1 will be removed on that date. We apologize for any inconvenience this may cause and would like to remind you that version 2 offers improved functionality and better performance. If you have any questions or need assistance with the migration process, please don't hesitate to contact our support team. Thank you for your cooperation and understanding.

 

Important - Evolution of La Banque Postale identification keypad from 13rd, June 2023: see the documentation here and test the new version here.

 

New features expected from Jun. 13th, 2023 : 

    • AISP 1.6 API : 
      • GET v2/transactions : Valuation of the BankTransactionCode
      • GET v2/owners & v2/overdrafts : minor improvements
    • PISP API : 
      • Technical securitisations
      • Anonymisation of the creditor's iban in the REDIRECT flow
    • New CBPII PSD2 STET 1.6 product (v2)

 

New features since Mar. 28th, 2023 :

    • AISP API : 
      • New AISP PSD2 STET 1.6 product (v2)
        • New operation /accounts/{id}/owners
        • New operation /accounts/{id}/overdrafts
      • New AISP PSD2 STET 1.6 Sandbox product
      • Valuation of the bicfi in the /accounts operation
    • PISP API : Minor bug fixes and technical securitisations
    • Oauth2 worflow for AISP/CBPII : 
      • Improvement of return codes in case of error (see documentation here)
      • Display of the phone number in the Certicode OTP path.

 

New features since Jan. 31st, 2023 :

    • PISP API : Enhancement of the debtor.name / Technical improvement of status retrieval for historical payments

    • All APIs : Increase of rate-limit allowed on default subscription / Minor improvements

    • Register API : Ability to update an APP

    • AISP API : Compliance of available transaction history (90 days)


New features since Dec. 1st, 2022 :

    • PISP API : Technical improvement of status retrieval for historical payments

    • All APIs : Change of domain for WEB-REDIRECT's urls.

    • Sandbox PISP /AISP : Minor improvements

    • CBPII API : Bug fix



Dec 01st, 2022 - Information : A technical intervention will take place on 01/12/2022 between 10:00 and 12:00. This may result in an interruption of service for a few minutes on the AISP and PISP APIs.

 

Nov 02nd, 2022 - Correction of the problem impacting the sandbox endpoints.

 

Oct 18th, 2022 - Correction of the problem impacting the App2App AISP flow: The deployment on the stores of the new version of the La Banque Postale app 22.3.1-38 solves the incident and makes the App2App flow operational again.

 

New features since Sept. 27th, 2022 :

 

    • AISP/PISP API : Minor fixes and technical features

 

New features since August 16th, 2022 :

    • PISP API : Standing orders

 

New features since June 30th, 2022 :

    • AISP API : Technical fix

 

New features since March 29th, 2022 :

    • PISP API :
      • Possibility to initiate a payment with an amount lower than 1.5 Euros
      • Automatic rejection of the payment request not confirmed after a authorised delay (RJCT-RR04)
      • Consistency check of the creationDateTime field in the payment request
    • AISP API : 
      • Balances : Error 500 fix in get balance request for professional customers
      • Transactions : Reliability of transaction status

 

 New features since January 25th, 2022 :

    • PISP API :
      • Improvements on the valuation of the property debor.name on the GET /payment-requests

      • Improvements on the valuation of paymentInformationStatus/statusReasonInformation on the GET /payment-requests in the case of rejections of unfinished requests.

 

 New features since October 15th, 2021 :

    • PISP API :
      • Implementation of the App2App journey (redirect "fluide") via one optional header PSU-Workspace  ; new App versions required (iOS / Android)

 

New features since July 30th, 2021 :

    • AISP API :
      • Implementation of the App2App journey (redirect "fluide") via two new OAuth2 specific endpoints ; new App versions required (iOS / Android)
    • PISP API :Other minor fix : Minor evolution on the register API of portal developerSee details and all documentation in "API Products" section above
      • Information of the appliedAuthentication field on the GET /payment-request

 

 

New features since February 17th , 2021 :

  • AISP API :
    • Corporate delegate access can now access the API
    • Three months of history are now available for deferred debit cards
  • PISP API :
    • The beneficiary's IBAN is partially hidden in the redirect journey
    • BIC field of beneficiary is now optional in PISP request
    • SCT are now available for beneficiaries across the whole SEPA zone
    • Bug fix : EndToEndId field supported in PISP request
    • Bug fix : localInstrument field is not mandatory for SCT payment request
  • Other minor fix : see documentation in ‘API Products’ section and fallback documentation in ‘Support’ section

 

 

 

02/05/2023 - PSD2 PISP API information : A technical maintenance took place between 22:10 and 22:40. This event caused a temporary unavailability of the transfer initiation service. It affected all the bank's channels (TPP and online banking).

 

28/03/2023 - PSD2 OAUTH2 API information : A technical maintenance has affected the TPP enrolment flow in REDIRECT WEB mode (with an error code SYNTAX_ERROR) since 28/03/2023 15:00. The App2App flows are not affected. The problem has been solved on 29/03/2023 11:00.

 

17/02/2023 - PSD2 PISP API information : A technical incident has affected the finalisation of some transfers ( especially those processed by the App2App workflow and whose characteristics do not require an SCA). The impact was a bad reception by the TPP of the psuAuthenticationFactor parameter. A fix was implemented on 23/02/2023. Incident resolved.

 

08/02/2023 - PSD2 API information : A service interruption affecting TPPs approved in Lithuania (LT-BL-xxxx) took place from 08/02/2023 14:45 to 09/02/2023 12:35. The incident caused the unavailability of PSD2 endpoints. Incident resolved.

 

31/01/2023 - PSD2 API information : A service interruption impacting PSD2 APIs took place on the 31/01/2023 from 14:30 to 16:30.

 

29/11/2023 - PSD2 PISP API information : A technical issue on the POST /payment-requests/{id}/confirmation occured between 28/11/2022 21:00 and 29/11/2022 12:16. The problem affected the validation of transfers. Incident resolved.

 

09/11/2022 - PSD2 API (transactions) information  : A service interruption impacting all La Banque Postale channels (online banking, app, API) between 13:08 and 14:50. The incident caused the unavailability of the GET /transactions endpoint. Incident resolved.

 

03/11/2022 - PSD2 API information : A service interruption impacting all PSD2 APIs took place on the 03/11/2022 from 11:30 to 15:30. The incident caused API DSP2 endpoints to be unavailable. Incident resolved.

 

01/10/2022 - DSP2 API information: A technical maintenance on the technical infrastructure took place from 01/10/2022 23:00 to 02/10/2022 01:30 with risks of isolated unavailability on the PISP API and on the AISP balance refresh.

  

21/09/2022 - DSP2 API information: A technical maintenance on the technical infrastructure took place from 21/09/2022 21:00 to 22/09/2022 10:00 with risks of isolated unavailability on the APIs.

 

15/09/2022 - DSP2 API Information:  A service interruption impacting all La Banque Postale channels (online banking, app, api) since 11:00am. The incident causes API DSP2 endpoints unavailable. Incident resolved since 17/09 17:00.

 

30/08/2022 - DSP2 API information : As of 30/08, labanquepostale.com domains will no longer be accessible in TLS1.0 and TLS1.1. TLS1.2 or higher must be used.

 

05/07/2022 - DSP2 API information :From 30/08/2022 the obsolete TLS1.0 and TLS1.1 protocols will be removed. If the time to switch to a TLS1.2 (or >) protocol is not sufficient, please contact us on the support email address before the 05/08/2022.

 

17/06/2022 - PSD2 API information : A service interruption impacting all La Banque Postale channels (online banking, app, api) took place on the 16/06/2022 from 19:04 to 21:30. The incident caused some API DSP2 endpoints to be unavailable. Incident resolved.

 

01/06/2022 - PSD2 API Support: Due to a technical problem, the support email above was not available between 01/06/2022 and 13/06/2022.

 

02/06/2022 - PSD2 API PORTAL: Technical maintenance on the developer portal took place on 02/06/2022 between 09:30 and 18:00 with unavailability of the portal.

 

19/05/2022 - PSD2 API information : A technical issue on the Certicode Plus service occurred between 19/05/2022 17:20 and 19/05/2022 21:00. The incident caused errors on enrollment and payment flows. Incident solved.

 

14/04/2022 - PSD2 API PORTAL: Technical maintenance on the developer portal took place on 14/04/2022 between 14:00 and 18:00 with unavailability of the portal.


29/03/2022 - PSD2 API PORTAL REGISTER API information: A technical problem on the POST/register has occurred between 29/03/2022 and 12/04/2022. The problem prevents the creation of new applications. Incident solved.

 

17/02/2022 - PSD2 PISP API information : A technical issue on the GET /payment-requests/{id} occured between 16/02/2022 15:00 and 18/02/2022 14:05. The problem caused 500 return codes out of the API. Incident resolved.

 

05/02/2021 - PSD2 API information : A service interruption impacting all La Banque Postale channels (online banking, app, api) took place last weekend from 05/02 around 22:30 with a restoration of service gradually on 06/02 around 19:00. The incident caused some API DSP2 endpoints to be unavailable. Incident resolved.

 

25/01/2021 - PSD2 API information : A technical issue on the PSD2 APIs occurred between 25/01/2022 14:46 and 25/01/2022 15:11. The incident caused API unavailability (500 return codes). Incident resolved.

 

10/12/2021 - PSD2 PISP API information : A technical issue on the POST /payment-requests/{id}/confirmation occurred between 08/12/2021 14:30 and 10/12/2021 08:55. The generation of the psuAuthenticationFactor parameter was affected ("undefined") thus blocking the POST/confirmation API (returns 403). Incident resolved.

 

16/11/2021 - PSD2 PISP API information : A technical intervention on the instant transfer systems will take place on 21/11/2021 between 2am and 5am. These maintenance operations could disrupt the operation of the PISP APIs with errors or resumption at 5am in the execution of instant transfers initiated between 2am and 5am.