Skip to content
XS2ABank - PSD2 XS2A Dynamic Sandbox
Branch: develop
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitlab/issue_templates added template for issue with Definition of Done Mar 20, 2019
arc42 Rewrote README, added all dependencies to Makefile, fixed links in ge… May 6, 2019
bank-profile Shifted profile approached May 6, 2019
certificate-generator Start next iteration with 1.1-SNAPSHOT May 10, 2019
db-scripts added db script Mar 21, 2019
developer-portal-ui Add variables to control debug logging May 21, 2019
docs/release_notes Removed unnecessary docs May 3, 2019
integration-tests fixed integration tests May 20, 2019
oba-ui Add variables to control debug logging May 21, 2019
online-banking fixed integration tests May 20, 2019
psd2-api-gateway Start next iteration with 1.1-SNAPSHOT May 10, 2019
qa/pmd Adjust maven configuration Mar 20, 2019
scripts Set up new release scripts Mar 20, 2019
tpp-ui Add variables to control debug logging May 21, 2019
.editorconfig Added start section to Makefile May 8, 2019
.gitignore Feature/fix tpp ui v1.0 May 20, 2019
.gitlab-ci.yml restored proper dockerhub releasing because the repositories are now … May 10, 2019
.gitmodules init git submodules May 8, 2019
.nvmrc Add building docker Mar 26, 2019
LICENSE Create LICENSE Apr 10, 2019
Makefile Added start section to Makefile May 8, 2019
docker-compose.yml Move connector examples docker to next hotfix 3.3.2 May 21, 2019
pom.xml Move connector examples to next hotfix 3.3.2 May 21, 2019
xs2a_code_style.xml added lombok, fixed project code style Mar 20, 2019


Implementation of the dynamic sandbox based on the adorsys ledgers core banking system and XS2A services.

Running the XS2ASandbox

0.For build and run XS2ASandbox requires GNU Make to be installed on your local machine. Please, make sure it is installed.

1.Download the project and go to the project directory:

> git clone
> cd XS2A-Sandbox

2.This sandbox runs with the docker-compose that can be found at: docker-compose.yml and Makefile. But before you run this, first of all you should check if all build dependencies are installed:

> make check

If something is missing, install it to your local machine, otherwise the build will fail. List of dependencies that are required to use XS2ASandbox: Java 8, nodeJs, AngularCLI, asciidoctor, jq, docker, docker-compose, maven, plantuml. Here are links where you can install needed dependencies:

Dependency Link
Java 8
Node.js 11.x
Angular CLI 7.x
Asciidoctor 2.0
jq 1.6
Docker 1.17
Docker Compose 1.24
Maven 3.5
PlantUML 1.2019.3

Note 1: please, use Node.js version lower than 12 (e.g. 10.x.x or 11.x.x). Otherwise angular applications would not be built due to version conflicts.

Note 2: check amount of memory given to Docker (Open Docker Desktop -> Preferences -> Advanced -> Memory). For a fast and painless start of all the services it should be not less than 5 GB.

3.Build and run the project with Makefile:

> make run

4.Open Developer Portal and follow the manual to start working with XS2ASandbox.

5.Stop running containers in terminal with key combination Control + C.

6.Afterwards you can remove all the Sandbox containers from Docker with the following command:

> docker-compose rm -s -f -v

Links to local Swagger Interfaces

Following urls will access the swagger interfaces:

XS2A Interface



ASPSP-profile is a module where bank-specific settings are stored.


Links to local User Interfaces

Developer portal UI

Developer portal is the main information resource on how to get started, how to test and work with XS2ASandbox.


Online banking UI

Online banking UI is an Angular application, developed to provide consents, payment confirmations and cancellation from PSU to ASPSP in case of redirect SCA approach.



TPP UI is an Angular application, which provides a user interface to TPP and allows to register, get test certificate and manage users and accounts.

You can’t perform that action at this time.