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 établissement | Nom de l'établissement | Nom abrégé | Disponible en Try-it et Assemblage | Disponible 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 |