Get a list of current accounts
Description :
This call retrieves the list of payment accounts from the PSU (user of a payment service) for which the AISP (payment service provider) is connected.
Each account is returned with the links allowing to consult the balances or the outstanding as well as the transactions associated with this one.
A pagination of the returned list can be done if the number of accounts is high, in this case navigation links giving access to the first page, the previous one, the next one and the last page will facilitate the consultation of the results.
A self link will also 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 TPP without customer connection, excluding pagination..
Request
"get/accounts"
Parameters
No specific parameter is required when calling this service (apart from the oauth2 token).
Exemple :
Request
GET /stet/psd2/v1/accounts/
Result
Status code : 200
Body
{ "_links": { "last": { }, "self": { }, "first": { } }, "accounts": [ { "cashAccountType": "CACC", "accountId": { "iban": "FR353000799999A40166510BB25" }, "balances": { "balanceType": "CLBD", "name": "Solde en capital", "referenceDate": "2019-3-5", "balanceAmount": { "amount": "18217563.75", "currency": "EUR" } }, "ressourceId": "EURFR353000799999A40166510BB25", "usage": "ORGA", "name": "Compte client 1", "bicFi": "NATXFRPP", "currency": "EUR", "links": { "balances": { "templated": false, }, "transactions": { "templated": false, } } }, { "cashAccountType": "CACC", "accountId": { "iban": "FR203000799999A40166510CC89" }, "balances": { "balanceType": "CLBD", "name": "Solde en capital", "referenceDate": "2019-3-5", "balanceAmount": { "amount": "7255.44", "currency": "EUR" } }, "ressourceId": "EURFR203000799999A40166510CC89", "usage": "ORGA", "name": "Compte client 2", "bicFi": "NATXFRPP", "currency": "EUR", "links": { "balances": { "templated": false, }, "transactions": { "templated": false, } } }, { "cashAccountType": "CACC", "accountId": { "iban": "FR053000799999A40166510DD56" }, "balances": { "balanceType": "CLBD", "name": "Solde en capital", "referenceDate": "2019-3-5", "balanceAmount": { "amount": "158789.33", "currency": "EUR" } }, "ressourceId": "EURFR053000799999A40166510DD56", "usage": "ORGA", "name": "Compte client 3", "bicFi": "NATXFRPP", "currency": "EUR", "links": { "balances": { "templated": false, }, "transactions": { "templated": false, } } }, { "cashAccountType": "CACC", "accountId": { "iban": "FR533000799999A661665104443" }, "balances": { "balanceType": "CLBD", "name": "Solde en capital", "referenceDate": "2019-3-5", "balanceAmount": { "amount": "56754.45", "currency": "USD" } }, "ressourceId": "USDFR533000799999A661665104443", "usage": "ORGA", "name": "Compte client 4", "bicFi": "NATXFRPP", "currency": "USD", "links": { "balances": { "templated": false, }, "transactions": { "templated": false, } } }, { "cashAccountType": "CACC", "accountId": { "iban": "FR823000700999A40166510EE50" }, "balances": { "balanceType": "CLBD", "name": "Solde en capital", "referenceDate": "2019-3-5", "balanceAmount": { "amount": "-4367.78", "currency": "EUR" } }, "ressourceId": "EURFR823000700999A40166510EE50", "usage": "ORGA", "name": "Compte client 5", "bicFi": "NATXFRPP", "currency": "EUR", "links": { "balances": { "templated": false, }, "transactions": { "templated": false, } } } ], "connectedPsu": "Marc" } |
Acceptance
These tests aim to ensure that the API complies with the STET standard. They should be validated before any application deployment.
Description | Type | Data to use |
Retrieve all accounts of a PSU | Mandatory | Persona : User : WUBUPA57 Result : 5 accounts |
Retrieve account of non recheable user | Mandatory | Persona : User: MOVEZY48 Result: 404 code status |