Get a list of balances
Description
This call retrieves the list of balances from a payment account of the PSU (user of a payment service) for which the AISP (payment service provider) is connected.
This service follows the return of a client's payment account list: a resource identifier corresponding to an account must be provided to obtain the list of balances.
A type of balance is returned in the case of an account passed as a parameter: Accounting Balance ("CLBD" in the STET standard) => accounting balance on D-1
A self link will be present to return to the page obtained just after execution of the request.
Access to this method is limited to a maximum of 4 batch accesses per calendar day, for a client, for an account or for a TPP.
Request
"get/accounts/{accountRessourceId}/balances"
Parameters
Parameter accountRessourceId : payment account for which we want to consult the balances, this data corresponds to the "resourceId" section obtained in the result page of the get / accounts query.
Request
GET /stet/psd2/v1/accounts/EURFR353000799999A40166510BB25/balances
Result
Status code : 200
Body
{ "balances": [ { "balanceType": "CLBD", "name": "Solde en capital au 2019-3-6", "balanceAmount": { "amount": "18217563.75", "currency": "EUR" }, "referenceDate": "2019-03-06" } ], "_links": { "self": { } } } |
acceptance
The purpose of these tests is to ensure that the API complies with the STET standard. They should be validated before any application deployment.
Description | Type of test | Data to use |
Retrieving all balances from an account | Mandatory | Persona : User : WUBUPA57 Account: EURFR353000799999A40166510BB25 Result : Balance of the account |
Retrieving balance from an unknown account | Mandatory | Persona : User: WUBUPA57 Account : EURFR7630007999990409797000000 Result : 404 code status |
| Mandatory | Persona : User : WUBUPA57 Account : EURFR353000799999A40166510BB25 Result : 403 code status |