It is only possible to import a bank connection. There are no services for importing or updating individual accounts. Accounts relate to bank connections, and whenever you import or update a bank connection, all accounts associated with this bank connection are imported/updated.

Prerequisites

Step 1 - Request to generate a web form to import a bank connection

Use Import a Bank Connection endpoint in Web Form 2.0:

POST /api/webForms/bankConnectionImport
CODE

We recommend to set accountTypes parameter and specify only those account types which apply to your business case. When you provide this parameter, the API will attempt to import only those accounts types and stop once we have covered every account type that is requested. (BAUSPAREN┃CHECKING┃CREDIT_CARD┃LOAN┃MEMBERSHIP┃SAVINGS┃SECURITY)

We use different protocols (interfaces) for different account types. The end-user will be asked if they would like to loop over the entire workflow until we get all requested account types. To optimize the experience for the end-user, provide only those account types that apply to your use case.


Step 2 - User to log in at the bank and authorise access

As a result of Step 1, the web form is generated. You can find the URL of the web form in the response:

url: "https://webform.finapi.io/wf/946db09e-5bfc-11eb-ae93-0242ac130002"
CODE

The Web Form has to be presented to the user to authorise access (login at the bank and complete the second-factor authentication procedure).

You have two options on how to present the webform to the user:

There are several branding and customization possibilities available for the web form. Please check out the web form documentation: https://documentation.finapi.io/webform/Whitelabeling.2066612596.html.

Step 3 - Check the status of the Web Form

To retrieve the status of the web form, you can either call the Get a web form service or register to receive a callback once the web form is completed (callback URL must have been registered during Step 1).

Note that the bankConnectionId is returned in the response (in the payload object) to get the status of the bank connection in the next step.

More details are available here.

Step 4 - Check the status of the bank connection

To retrieve the status of the bank connection, get the bankConnectionId from Step 3 and execute Get a bank connection:

GET /api/v1/bankConnections/{id}
CODE

Please beware that it takes some time to download the accounts and transactions from the bank. For more details, please check Post Processing of Bank Account Import/Update.

Step 5 - Get Accounts and Transactions

To query the account data for the imported bank connection, please use Get and search all accounts endpoint. There are many filtering options available such as by accountTypes, id, and more. Please refer to the API documentation for all available filters.

GET /api/v1/accounts
CODE

You can query transactions for one of the imported account/bank or all imported accounts/banks.

Please use Get and search all transactions endpoint.

GET /api/v1/transactions
CODE