Get a list of current accounts

ligne89C3

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