Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

General information

The finAPI Test Bank for redirect allows you to test the redirect flow with the XS2A interface. The test bank contains a fixed set of accounts and transactions, no communication to external banking systems occurs.

The finAPI Test Bank for redirect has the name “finAPI Test Redirect Bank” and the BLZ is DEMO0002.

 

Info

Request and response examples are provided here: https://finapi.jira.com/wiki/spaces/ACCDOC/pages/626491433/Approaches+explanation#Decoupled-approach

Please use bankId, interface, login credentials and two-step procedures as provided below.

Bank Id

Please use 280002as bankId for this test bank.

Note: you can always find the bankId when searching for a bank via Get and search all banks service.

Interfaces and capabilities

The bank supports the XS2A interface and has the REDIRECT_APPROACH property set.

It is possible to import a bank connection and initiate a SEPA Money Transfer with this bank.

Accounts and Transactions

2 Checking Accounts and 1 Savings Account are available for this test bank.

New transactions will be generated for the test accounts on a daily basis.

Credentials

The following credentials are required for accessing the test bank:

  • Onlinebanking-ID: demo

  • PIN: demo

To trigger no SCA scenario, please use:

  • Onlinebanking-ID: demo_no_msa

  • PIN: demo_no_msa

Simulate errors

The following error cases can be simulated with the test bank:

Cancel the login

If you reject authorization by pressing the cancel button on the bank login page in step 2, you will be redirected in the same way as for a successful login which is the same behavior as for real banks. So in your application you will have no information about the login status during this step.

But if you proceed with step 3, you will get the following error response:

Code Block
HTTP/1.1 422
Date: Wed, 18 Mar 2020 14:17:28 GMT

{
  "errors": [
    {
      "message": "The authorization was cancelled by the user.",
      "code": "BANK_SERVER_REJECTION",
      "type": "BUSINESS",
      "multiStepAuthentication": null
    }
  ],
  "date": "2020-03-18 15:17:27.594",
  "requestId": "selfgen-e564f74a-1fb8-4953-bb10-a64e87a99951",
  "endpoint": "POST /api/v1/bankConnections/import",
  "authContext": "2/519336",
  "bank": "DEMO0002 - finAPI Test Redirect Bank"
}

Enter wrong credentials

If you enter wrong credentials on the demo bank login page opened in step 2, you will see an error message directly on the page:

...

Leaving the dialog by pressing “Login” is not possible with empty or wrong credentials, the dialog can only be closed by cancelling it.

Credential validation takes place directly on the page as for real banks. No REST API calls are involved.

...

Note

This page is now deprecated. We urge you to check out our new Access Public Documentation that we recently published instead, which covers all state-of-the-art information of our products.

Note: due to overall restructuring for our new Access Public Documentation, there might not be a corresponding page with the exact same content like this deprecated page in our new documentation. However, we make sure to already cover all information you need, including this content, in our new documentation.