This API allows a Belfius customer to view his account details and its associated balances within a TPP application.
Belfius supports multi-currency account. In this case, the returned account balance is always a balance in euro. This balance is associated to the balance of the euro compartment or the globalized amount in euro of the balance of all compartments (depending on the parameter of the account). A list of each currency compartment with its balance is also provided in the API response.
The steps are as follows:
This API allows a Belfius customer to view the transaction history of his account within a TPP application.
Belfius supports multi-currency account. To retrieve transactions of a specific currency compartment the currency parameters should be filled in. If no currency is given in input, only the euro transactions will be returned.
The steps are as follows:
To keep accessing customer transaction history after 90 days, the PSU will be required to perform again a customer authentication. The specific flow linked to this case is explained in the below section. Up-to-date account balance will still be available to the PSU without the customer authentication.
Retrieving transactions older that 90 days can be done at every moment by the PSU. However two different flows have to be distinguish
After account enrolment, the POST /token API called with a scope “AIS” and with “authorization_code” as grant_type will returned a “SCA token”. This “SCA token” (valid for a period of 1 hour) should be passed as parameter of GET transaction request to retrieve the full transaction history.
The specific flow linked to the second case (at any moment except after account enrolment) is explained in the below section.
As explained above, the PSU needs to perform a new authentication if
The steps are as follows:
Note that in case where the PSU wants to retrieve transactions older than 90 days, an “SCA token” will be passed after the successful PSU authentication into Belfius environment. This “SCA token” (valid for a period of 1 hour) should be passed as parameter of the request. This will allow the TPP to keep retrieving older transactions without having to redo an SCA at each request.
Four unattended calls can be perform on AIS APIs per 24 hours.
In order to do so, the TPP should filled in the “psu_involved” parameter with false. Note that if this parameter is empty, Belfius considers that the PSU is not present. This call will therefore be counted by Belfius as unattended.