Skip to content
No description, website, or topics provided.
Branch: develop
Clone or download
Latest commit f58668e May 21, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
adapters Merge pull request #76 from adorsys/spe/archetype May 21, 2019
devops rename environment properties May 15, 2019
docs add documentation for dkb adapter May 15, 2019
postman Added Postman script for get balances request. May 17, 2019
xs2a-gateway-app move exception handler to rest module May 14, 2019
xs2a-gateway-service-api-adapter Refactored code style of classes May 21, 2019
xs2a-gateway-service-api Refactored code style of classes May 21, 2019
xs2a-gateway-service-loader Refactored code style of classes May 21, 2019
.gitignore Create initial structure from service-archetype Apr 2, 2019
.travis.yml adjust travis ci Apr 3, 2019
Dockerfile add SSL_OPTS parameter to docker file. add secret storage to deployme… Apr 19, 2019
LICENSE Create LICENSE Apr 5, 2019 adjust adapters location Apr 26, 2019
pom.xml Merge branch 'develop-fork' into feature/MSH/request_signing May 7, 2019


Build Status

There are various ways for a bank to implement a PSD2 compliant XS2A interface. Don’t waste time in connecting different banks with different approaches into your application. Use the free of charge XS2A adapter and concentrate on your true value proposition!

Who we are

adorsys is a company who works ever since the very beginning of PSD2 with its requirements and implicit tasks. We help banks to be PSD2 complaint (technical and legal terms). To speed up the process we provide this open source XS2A interface, specified by Berlin Group, that can be connected to your middleware system. You can check your readiness for PSD2 Compliance and other information via our Web-site.

What this Project is about

Key Challenge for a TPP in Europe

PSD2 as the first regulatory driven Open Banking initiative offers many opportunities for both Banks and Third Party Providers. TPPs can use the account information and payment services provided by the banks in order to offer new innovative services to the end users. The more banks a TPP can interact with the more users it can reach with its application, which in consequence raises the value of the application itself.
However, being able to interact with many banks can be a time and cost consuming challenge when developing and maintaining an application. Even though PSD2 sets a standard for bank interfaces, much space for implementation options remains. A bank, therefore, can have an own PSD2 compliant solution or have implemented one of the mayor PSD2 standards, like Open Banking UK, Berlin Group or STET. A PSD2 adapter must be able to process the different messages correctly and react fast to changes on the XS2A interfaces.

XS2A Adapter Solution by adorsys

The XS2A Adapter is a service component for Multi-Banking Applications. On one hand, you can interact with the adapter through an own interface based on the Berlin Group Specification. On the other Hand, it can communicate with different PSD2-interfaces from various Banks in Germany and Europe. Our solution is Open Source and free of charge. It can easily be embedded in your application using either a java or a REST client. With the help of a growing community our adapter is kept up-to-date regarding the changes on the XS2A interfaces of the banks. Also, as part of our product vision, a core team will be interacting with the community in order to keep connecting new banks to the adapter.

High level architecture

High level architecture

Getting Started


  • Java JDK version 1.8.x, Maven 3.x;

Clone git repository and build a project:

$ git clone
$ cd xs2a-gateway
$ mvn clean install

Embedded mode

If you want to integrate xs2a-gateway into your java application you need just add next dependencies in your classpath:

  • xs2a-gateway-service-impl
  • adapters/deutsche-bank-adapter
  • ... all other bank adapters adapters/*-adapter

Standalone mode

If you want to install our xs2a-gateway as standalone application, you need just run next commands

  • cd xs2a-gateway-app/target/
  • java -jar xs2a-gateway-app.jar

Application will be available by address http://localhost:8081/swagger-ui.html

How to write your own adapter

Read this short guideline to get more details


Built With

Releases and versions

Testing API with Postman json collections

For testing API of xs2a it is used Postman Environment jsons with global parameter’s sets and Collections of jsons for imitation of processes flows are stored in /postman folder. To import Postman collections and environments follow next steps:

  1. Download Postman jsons with collections and environments to your local machine.
  2. Open Postman, press button “Import”.
  3. Choose “Import file” to import one json or “Import folder” to import all jsons within the folder, then press button “Choose Files” or “Choose Folders” and open necessary files/folders.
  4. To change settings of environments - go to “Manage Environments”, press the environment name and change variables.

To start testing with Postman collections it is necessary to have all services running.

Authors & Contact

See also the list of contributors who participated in this project.

For commercial support please contact adorsys Team.


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

You can’t perform that action at this time.