This document models the association between financial data held in a LibEuFin demobank and the interface to let users access such financial data.
LibEuFin Sandbox offers multitenency banking by the means of ‘demobanks’. Each demobank offers access to financial data via several APIs. The objective is to model such APIs so that each operation impacts one and only one demobank.
Each API to access financial data at one demobank is offered by a resource called protocol supplier. Therefore protocol suppliers MAY be subject to all the CRUD operations
For each request that a protocol supplier serves, the demobank being impacted can be found in the following ways:
Note: the three elements are mutually exclusive, so as to reduce ambiguity and simplify the implementation.
Suppliers can be static or dynamic.
This supplier never changes its state. Whether this type of supplier is associated or not with a particular demobank MUST be stated in the documentation.
1. A JSON-based protocol that lets users access their bank accounts always under the ‘default’ demobank belongs to this category. It is therefore a ‘static protocol supplier’ with static demobank.
2. A XML-based protocol that lets users access their bank accounts in a demobank whose name appear in the URI is as well a ‘static protocol supplier’ with dynamic demobank.
Note: the upcoming (in version 0.9.3) JSON-based supplier that will let Nexus reach Sandbox accounts is planned as a ‘dynamic protocol supplier’ with dynamic demobank. That allows Taler demos to only speak JSON.
This supplier has a name and its state CAN refer to one particular demobank. These suppliers need to be created first, in order to be used.
1. A JSON-based protocol that lets users access their bank accounts under the demobank whose name is held in the supplier state belongs to this category. It is therefore a dynamic supplier with semi-dynamic demobank.
2. A XML-based protocol that lets user access their bank accounts under the demobank whose name is held both in the supplier state and in the URI is wrong. This supplier doesn’t respect this mutual exclusivity.
3. A XML-based protocol that lets user access their bank accounts always under the ‘default’ demobank belongs to this category. It is a dynamic supplier with static demobank. Note: this is the case of EBICS access offered in LibEuFin 0.9.2.
Each supplier must be available under its own URI.