delokman/xs2a-sandbox

XS2ABank - PSD2 XS2A Dynamic Sandbox

ModelBank

What is it

With PSD2 Directive (EU) 2015/2366 of the European Parliament and of the Council on Payment Services in the Internal Market, published 25 November 2016 the European Union has forced Banking Market to open the Banking Services to Third Party Service Providers (TPP). These services are accessible by TPP on behalf of a Payment Service User (PSU).

The 'Berlin Group' is a pan-European payments interoperability standards and harmonisation initiative. Based on the PSD2 and EBA RTS requirements, Berlin Group NextGenPSD2 has worked on a detailed Access to Account (XS2A) Framework with data model (at conceptual, logical and physical data levels) and associated messaging.

ModelBank is a dynamic sandbox environment that allows to emulate and test ASPSP's OpenAPI PSD2 services.

ModelBank is based on XS2A Service, XS2A-connector-examples and Ledgers.

With ModelBank TPP UI, you as a testing TPP can access banking APIs directly, get TPP certificates and manage testing accounts.

Developer Portal contains testing instructions and all of the necessary documentation.

All four SCA approaches are supported: REDIRECT, OAUTH, EMBEDDED, DECOUPLED. Two of them (REDIRECT, EMBEDDED) are directly testable on Developer portal. For the Redirect SCA Approach an Online Banking UI is used for authorisation.

Project documentation

• Release notes contain information about changes included into releases.
• User Guide describes how to configure the ModelBank.
• UI Customization guide describes how to customize Developer Portal, Online Banking UI and TPP UI.
• Architecture Documentation describes how to instal, create and use tools for our diagrams.

How to try it

• Running ModelBank instructions will help you getting you a copy of the project up and running on your local machine.

Version policy

In general ModelBank Team follows SemVer for versioning. This means our versions follow the model A.B.C, where:

• A - is the major version, pointing out mainline.

• B - is the minor version, pointing out the next release in the mainline.

• C - is the hotfix version, used to deliver patches between releases when needed. If omitted, version 4.5 will be considered equal to 4.5.0.

We support one release version at the moment.

Normally new version is released every two weeks, however this is not a strict rule, rather our willingness.

Development and contributing

Any person is free to join us by implementing some parts of code or fixing some bugs and making a merge requests for them.

Contribution Guidelines describe internal development process and how to contribute to the ModelBank.

Contact

If you think that our system behaves in an unexpected way or incorrect, or you need some clarifications, to contact ModelBank Team please create an issue. Team will provide comments and feedback there.

For commercial support please contact adorsys Team.

License

This project is licensed under the Apache License version 2.0 - see the LICENSE file for details.