Limitations

➤ Limitations fonctionnelles

Limitations de cette API DSP2

  • S'applique à toutes les Caisses d'Epargne sauf cas particulier éventuellement décrit dans cette section
  • Ne s'applique qu'aux comptes de paiements en euros actifs accessibles en ligne (cf. texte de la Directive PSD2), et aux virements externes entre comptes
  • N'utilise que le mode d’authentification REDIRECT renforcé (appel de la méthode o-confirmation pour que le TPP confirme le paiement après Authentification Forte du PSU demandée et gérée via la banque : l'ASPSP transmet un code d'authorisation OAUTH2 au TPP qui doit le renvoyer à l'ASPSP pour confirmer le paiement)

NB : le TPP n'a pas la possibilité de fournir à l'ASPSP les données de sécurité personnalisées du client à des fins d'authentification, et donc, seuls les écrans de redirection et d'authentification forte (SCA) de l'ASPSP doivent être utilisés (l'encapsulage de ces écrans par le TPP est interdit au regard des articles PSD2 #97.5 et RTS #31)

  • Ne traite que les demandes d'initiation de paiement en euro (pas d'initiation de virement en devise)
    • SCT Core de type immédiat ou différé ou permanent pour les segments de clients PART/EI/PRO/ENT
    • SCT INST pour les segments de clients PART/EI/PRO/ENT (SAUF pour les CE Ile de France et CE Auvergne Limousin : que pour les PART/EI)
  • Le BIC Creditor n'est pas nécessaire SAUF pour les opérations PIS hors zone SEPA (toujours en euro)
  • Les méthodes suivantes sont disponibles :
    • POST /payment-requests et POST /payment-requests/{paymentRequestRessourceId}/o-confirmation pour initier un paiement
    • GET /payment-requests/{paymentRequestRessourceId} pour récupérer le statut d'une initiation de paiement

      NB : Les méthodes suivantes ne sont PAS supportées : 

POST /payment-requests/{paymentRequestRessourceId}/confirmation et PUT /payment-requests/{paymentRequestRessourceId} (annulation de virement SCT différé initié via API)

  • L'annulation d'une demande de virement via API PIS peut être effectuée par le PSU via son accès direct (et non via API)
  • Les demandes PIS de type "CASH" seront rejetés si le PSU n'utilise pas un moyen d'authentification forte ayant un niveau suffisemment sécuritaire (Secur'Pass ou le certificat sur clé physique pour les PRO & ENT), et si l'IBAN bénéficiaire n'est pas enregistré au préalable sur son accès direct
  • Différentes demandes PIS ayant les mêmes caractéristiques qu'une executée préalablement (même jour, même IBAN debiteur et créditeur, même montant, etc...) seront rejetées (fonctionnement identique à la banque en ligne)
  • Si aucune action de l'utilisateur n'est effectuée au bout de 30 mns (04 mns sur les écrans de redirection), c'est considéré comme une déconnexion sans redirection en retour vers le TPP
  • La longueur du champs creditor.name est limitée à 32 caractères   

 

Limitations liées aux types de comptes accessibles

  • Les comptes accessibles via l’API PISP sont ceux disponibles sur la banque à distance éligibles DPS2 pour initier un virement SEPA vers un bénéficiaire externe
  • Il est à noter qu'en adéquation avec la réglementation, l'ASPSP peut appliquer des processus métiers (lutte anti-fraude, etc...) qui peuvent amener à rejeter l'exécution d'une initiation de paiement 

 

Limitations liées aux segments de clientèle 

Sont couverts par l'API les segments clients suivants :

  • Client "particulier" (y compris compte joint et mineur rattaché) ayant un abonnement à la banque en ligne "DEI PART" ou "DEI PRO" et un compte commençant par 04

NB 1 : le particulier (PART) est une personne physique catégorisée comme « majeur capable ». Le PART peut aussi avoir des activités dans le cadre d’une entreprise individuelle (EI) = une entreprise dirigée par une seule personne, et qui n'a pas le statut de "persone morale", bien qu'elle soit inscrite au répertoire des métiers ou au Registre du Commerce et des Sociétés (RCS, exemples : artisan ou profession libérale). Dans ce cas, l’EI est considéré comme un PART

NB 2 : est non compris à ce jour le tuteur de personne protégée/sous tutelle ou curatelle utilisant la solution Web Protexion 

  • Client "gros professionnel", "entreprise" et "association" ayant un abonnement à la banque en ligne "CE Net Compte" et un compte commençant par 08 autorisant les virements unitaires

NB 3 : les catégories "entreprise" (ENT) et "association" (ASSOC) couvrent les personnes morales 

 

Limitations liées aux moyens d’authentification forte

Il est de la responsabilité de l'ASPSP d'équiper ses clients avec un ou des moyens d'authentification forte : 

  • PART :       Accès aux comptes PART et Opération sensible / Dynamic linking (DL) :                                               (Sécur'Pass) ou (lecteur CAP) ou (Mot de Passe + OTP SMS)
  • PRO/ENT : Accès aux comptes PART et Opération sensible / Dynamic linking (DL) : (certificat matériel) ou (Sécur'Pass) ou (lecteur CAP) ou (Mot de Passe + OTP SMS)

         NB 4 : il n'y a pas d'exemption de la seconde authentification forte AF/SCA dynamic linking (donnée scaHint ignorée)

NB 5 : il y aura un rejet des virements avec categoryPurpose = « CASH » ou « SALA » lorsque l’AF/SCA DL ne se fait pas avec le moyen principal et que l'IBAN bénéficiaire n’est pas enregistré par le PSU sur sa banque en ligne

NB 6 : le certificat matériel n'est pas proposé aux client sur mobile/smartphone 

 

 

➤ Accès aux données de production

Conformément à la réglementation, les modes de test Try-it et Assemblage n'utilisent que des données fictives qui sont décrites dans le cas d'usage "Comment Tester l'API ?".

Pour accéder aux données de production, l'utilisation de l'API REGISTER est un prérequis (voir la fiche www.api.89c3.com/fr/component/bpceportal/products/522/usecases/523).

NB : La plage hebdomadaire du lundi matin de minuit à 06h00 est utilisée pour la maintenance des infrastructures des systèmes d'information (tous composants, y compris le système central/backend, les passerelles, etc...) et peut engendrer des requêtes API en erreur ou des indisponibilités le temps des interventions (de même pour des traitements bancaires programmés en début et fin de journée/mois/trimestre/année).

 

Le code établissement (voir la liste des établissements bancaires accessibles ci-dessous) vous permettra d'adresser le bon référentiel client via le "endpoint" www.<codetab>.live.api.89c3.com (ou www.<codetab>.live.api.caisse-epargne.fr aligné sur le nom de domaine de l'accès direct www.caisse-epargne.fr). Une fois choisi, ce point d'accès doit être conservé pour toutes les requêtes sous-jacentes.

Code établissementNom de l'établissementNom abrégéDisponible en Try-it et AssemblageDisponible en Production
11315 Caisse d'Epargne Provence Alpes Corse CEPAC  - Oui
11425 Caisse d'Epargne Normandie CEN  - Oui
12135 Caisse d'Epargne Bourgogne Franche-Comté CEBFC  - Oui
14445 Caisse d'Epargne Bretagne-Pays De Loire CEBPL  - Oui
13135 Caisse d'Epargne Midi-Pyrénées CEMP      - Oui
13335 Caisse d'Epargne Aquitaine Poitou-Charentes CEAPC  - Oui
13485 Caisse d'Epargne Languedoc-Roussillon CELR  - Oui
13825 Caisse d'Epargne Rhône Alpes CERA  - Oui
14265 Caisse d'Epargne Loire Drôme Ardèche CELDA  - Oui
14505 Caisse d'Epargne Loire-Centre CELC  - Oui
17515 Caisse d'Epargne Ile De France CEIDF Oui  Oui
18315 Caisse d'Epargne Côte d'Azur CECAZ   -  Oui
18715 Caisse d'Epargne Auvergne et Limousin CEPAL  - Oui
15135 Caisse d'Epargne Grand Est Europe CEGEE  - Oui
16275 Caisse d'Epargne Hauts de France CEHDF  - Oui

 carte FR CE