This request allows you to retrieve the list of reachable Payer PSPs in MyBank.
Typical use case
You want to collect the updated list of selectable Buyer Banks to be shown to the Payer.
Please note that this API *MUST NOT be invoked every time that this list is needed. Instead, this API *MUST be invoked once per day, preferably shortly after 00:15 UTC (the recommendation is to invoke it between 00:30 - 1:00 UTC; or, if you cannot handle UTC, between 2:30 - 3:00 CET); a cached copy of the response must be used for later use, until the next invocation on the following day.
(This is because the list may be updated every day. In case, updates will be published between 00:00 and 00:15 UTC).
The above recommendation remains valid regardless of whether the Payee PSP or the Payee is in charge of showing the list of Buyer Banks to the Payer. Either way, the Payee PSP *MUST ensure that up-to-date information is used to build the list at all time.
Request body attributes
All attributes in the request body are mandatory.
Typical use of the response
-
You will show the Payer a list of Buyer Banks, comprising all values of alias (regardless the value of country and language). The list MUST be displayed as received in the response (no filter, no change to the sort order).
(FYI only: unless special features are activated on our side, the list you receive will be sorted alphabetically by alias; the id is just a convenience sequential numbering). -
After the Payer has chosen one Buyer Bank from the list, you will need to retrieve for later use the corresponding language (to fill into paymentInitiateSCT01's request as "aliasLanguage") and participantID (to fill into paymentInitiateSCT01's request as "validationServiceID").