Build Status Quality Gate Status Coverage

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.

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

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

With XS2ASandbox 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.

XS2ASandbox structure

Project documentation

How to try it

Version policy

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

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 are 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 XS2ASandbox.


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

For commercial support please contact adorsys Team.


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