Retrieve the Trusted beneficiaries (AISP)
Description
This call allows you to retrieve the list of trusted beneficiaries from the PSU (user of a payment service) for which the AISP (payment service provider) is connected.
This service requires that the PSU be subscribed to the portal services "Consultation of the list of beneficiaries (VLCB)" or "Modification of the list of beneficiaries (SLCB)".
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 /trusted-beneficiaries »
Parameter
No specific parameter is required when calling this service (apart from the oauth2 token).
Example
Request
GET http://localhost:8080/v1/trusted-beneficiaries
Result
Status code : 200
Body
{ "_links": { "self": { } }, "beneficiaries": [ { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR7630007999999401665105511" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers1" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR7630007999990661665104493" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers2" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR963000799999866166510BB50" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers3" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR813000799999866166510CC17" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers4" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR663000799999866166510DD81" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers5" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR643000799999A66166510EE10" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers6" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR7630007999999661665109960" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers7" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR7630007999990771665109968" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers8" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR983000799999077166510A044" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers9" } }, { "creditorAgent": { "bicfi": "NATXFRPP" }, "creditorAccount": { "iban": "FR373000799999A77166510A091" }, "creditor": { "postalAddress": { "country": "FR", "addressLine": "Adresse du beneficiaire 75000 PARIS" }, "name": "Tiers10" } } ] } |
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 | Data to use |
Retrieval all the trusted beneficiaries from a PSU | Mandatory | Persona : User : WUBUPA57 Result : List of the 10 beneficiaries |
HTTP request with an invalid token | Mandatory | Persona : User : WUBUPA57 Result : 403 status code |
Retrieval all the trusted beneficiaries from an unknown PSU
| Mandatory | Persona: User: MOVEZY48 Result : 404 status code |