After the successful bank login in order to access the account data (details, balances, transactions, payments), accounts need to be fetched from the bank and activated in Everifin.
Accounts
...
Data
The list of accounts the bank provides after the successful bank login can be obtained using the endpoint described here: Get Bank Accounts
Accounts Activation
The Accounts chosen for further access/usage need to be activated using the endpoint described here: Bank Accounts Activation.
After the successful activation the account data can be accessed using further endpoints described here: Bank Accounts Endpoints
...
Transactions Data
The following endpoints needs to be used in order to access the transaction data.
Transaction refresh
Transactions are refresh refreshed periodically in following pattern:
user is online - transactions are refreshed every minute
user is offline - transactions are refreshed 4 times during work hours
...
every 30 minutes
for all users - transaction update job is triggered twice a day
Manual transaction refresh
In addition to periodic transaction refresh provided automatically by the system, transaction refresh can be triggered manually by calling a dedicated endpoint. This endpoint initiates the download of the transaction data from the bank to Everifin for all user’s connected active bank accounts. Downloaded and stored transactions can be then accessed using further endpoints.
...
Detailed endpoint description can be found here: Transaction Refresh Endpoint
Transaction update
Some banks might change the transaction data after transaction is processed in bank’s systems. After we receive new transaction data from bank, we update it and set new value for lastUpdated column.
To get only the fresh transactions (i.e. those which has not been downloaded yet or newly updated ones), good approach is to use updatedFrom query parameter and store the maximum value of lastUpdated field among all downloaded transactions. Next time you should call the endpoint with stored value plus 1 millisecond.
| Info |
|---|
Very first download When the bank account is connected for the first time and the initial transactions download from the bank towards Everifin is started, the most recent transactions are stored at first. Download and storing of historical ones follows afterwards. As a result, the older transactions can have more recent timestamp in field Therefore, if you do not want to get historical transactions, you may combine parameter like |
Only new transactions
If you do not want to get updates described above, then you can use query parameter createdFrom (ISO timestamp) and store value from field createdAt of latest transaction. Next time you should call the endpoint with stored value plus 1 millisecond.
Get Transaction List
Transaction list for specific bank account can be obtained using the endpoint described in detail here: Bank Account Transactions
Get Transaction Detail
The detail for particular transaction can be obtained using this endpoint described here: Get Transaction Detail.