DRAFT
Summary
This document is a starting point for finAPI customers for learning how to migrate to the PSD2 XS2A interfaces. This document provides an overview of the actions that have to be taken for the migration. The intended audience of this document are (BaFin/FMA) registered TPPs as well as finAPI customers using the finAPI PSD2 licence (web form).
Call to action for finAPI customers
All finAPI customers must migrate to XS2A interfaces before the deadline given by the National Financial Supervisory Authorities (BaFin, FMA). This migration must be actively performed by finAPI customers by using new finAPI services.
Migration principle
Since mid September, finAPI Access provides the means to migrate to new XS2A interfaces. The migration of a bank connection can be performed by executing one simple new service call to connect a new XS2A interface to an existing bank connection. This way, existing data is kept and can be updated through new XS2A interfaces. finAPI customers can choose for themselves when they want to perform the migration for which (group) of their customers. Legacy interfaces and XS2A interfaces can be used in parallel in separate bank connections until BaFin ends the exemption period.
Migration schedule
finAPI customers have been given the opportunity to start their migration development project since June 2019, when the first version of the new XS2A services has been released on the finAPI Alpha environment. The production version of the new finAPI XS2A services has been release beginning of September.
Kunden, die die finAPI PSD2 Lizenz / Webform nutzen, sind von diesen Umstellungen weniger stark betroffen, da viele Änderungen hier schon seitens finAPI in die aktuelle Version unserer Webform übernommen wurden. Dennoch muss auch hier die Umstellung auf die aktuellen XS2A Schnittstellen von unseren Kunden aktiv vorgenommen werden. (siehe Abschnitt „Connect new interface“)
Allgemeine Informationen finden Sie hier:
· Migrationsplan finAPI: https://teaminvest.jira.com/wiki/spaces/ACCDOC/pages/600997907/finAPI+Access+PSD2+Migration+Plan
Kunden mit einer eigenen Lizenz müssen sich bei den Banken für die Nutzung der Schnittstelle registrieren und die entsprechenden (TPP) Zugangsdaten bei finAPI hinterlegen. Auch das eIDAS Zertifikat muss bei finAPI hinterlegt sein.
· Übersicht über die Verwaltung des eIDAS Zertifikats
· Übersicht über Banken und TPP Authentication
https://teaminvest.jira.com/wiki/spaces/ACCDOC/pages/604471604/TPP+registration+and+authentication
· finAPI hat TPP Authentication Groups angelegt, für die diese TPP Zugangsdaten zu hinterlegen sind. Eine Übersicht über alle Gruppen erhält man als Admin unter dem Endpunkt
https://alpha.finapi.io/#!/TPP_Credentials/getAndSearchTppAuthenticationGroups
Die Zugangsdaten können dann für jede Gruppe über diesen Endpunkt hinterlegt werden
https://alpha.finapi.io/#!/TPP_Credentials/createTppCredential
Eine detaillierte Beschreibung aller API Änderung und der neuen Endpunkte ist hier zu finden:
· Beachten Sie bitte besonders den Abschnitt 7. „Connect a new interface“, um bestehende Verbindungen mit dem XS2A Interface zu erweitern
https://teaminvest.jira.com/wiki/spaces/ACCDOC/pages/560955393/Concept+PSD2+Integration
· Wenn Sie mehrere Interfaces für eine Verbindung hinterlegt haben finden Sie hier eine Übersicht, wie der Download über mehrere Interfaces verteilt vorgenommen wird
Mit der PSD 2 wurde auch die starke Kundenauthentifizierung (SCA) seitens der Banken eingeführt. Es gibt hier mehrere unterschiedliche Verfahren, die entsprechend implementiert sein müssen. Hier haben wir eine Übersicht vorbereitet, die die verschiedenen Methoden aufzeigt:
· Die Übersicht ist nach Nutzungsform (mit eigener Lizenz oder Nutzung via Webform) unterteilt
https://teaminvest.jira.com/wiki/spaces/PSD2/pages/626491433/Approaches+explanation+for+customers
Damit möglichst viele Szenarien getestet werden können haben wir hier die Funktionen der Demobanken aufgelistet. Wir arbeiten daran die finAPI Demobank entsprechend zu erweitern.
· Hier die Übersicht über die Testbanken und die Szenarien
https://teaminvest.jira.com/wiki/spaces/ACCDOC/pages/623182093/Testing+finAPI+Demo+Banks
Bitte stellen Sie, soweit möglich, auf die neuen XS2A Schnittstellen um. Wir erweitern das Angebot hier kontinuierlich.
Kunden mit einer eigenen Lizenz müssen sich bei den Banken für die Nutzung der Schnittstelle registrieren und die entsprechenden (TPP) Zugangsdaten bei finAPI hinterlegen. Auch das eIDAS Zertifikat muss bei finAPI hinterlegt sein.
· Übersicht über die Verwaltung des eIDAS Zertifikats
· Übersicht über Banken und TPP Authentication
https://teaminvest.jira.com/wiki/spaces/ACCDOC/pages/604471604/TPP+registration+and+authentication
· finAPI hat TPP Authentication Groups angelegt, für die diese TPP Zugangsdaten zu hinterlegen sind. Eine Übersicht über alle Gruppen erhält man als Admin unter dem Endpunkt
https://alpha.finapi.io/#!/TPP_Credentials/getAndSearchTppAuthenticationGroups
Die Zugangsdaten können dann für jede Gruppe über diesen Endpunkt hinterlegt werden
https://alpha.finapi.io/#!/TPP_Credentials/createTppCredential
Eine detaillierte Beschreibung aller API Änderung und der neuen Endpunkte ist hier zu finden:
· Beachten Sie bitte besonders den Abschnitt 7. „Connect a new interface“, um bestehende Verbindungen mit dem XS2A Interface zu erweitern
https://teaminvest.jira.com/wiki/spaces/ACCDOC/pages/560955393/Concept+PSD2+Integration
· Wenn Sie mehrere Interfaces für eine Verbindung hinterlegt haben finden Sie hier eine Übersicht, wie der Download über mehrere Interfaces verteilt vorgenommen wird
Mit der PSD 2 wurde auch die starke Kundenauthentifizierung (SCA) seitens der Banken eingeführt. Es gibt hier mehrere unterschiedliche Verfahren, die entsprechend implementiert sein müssen. Hier haben wir eine Übersicht vorbereitet, die die verschiedenen Methoden aufzeigt:
· Die Übersicht ist nach Nutzungsform (mit eigener Lizenz oder Nutzung via Webform) unterteilt
https://teaminvest.jira.com/wiki/spaces/PSD2/pages/626491433/Approaches+explanation+for+customers
Damit möglichst viele Szenarien getestet werden können haben wir hier die Funktionen der Demobanken aufgelistet. Wir arbeiten daran die finAPI Demobank entsprechend zu erweitern.
· Hier die Übersicht über die Testbanken und die Szenarien
https://teaminvest.jira.com/wiki/spaces/ACCDOC/pages/623182093/Testing+finAPI+Demo+Banks