Banks Management
White and Black List
Fabrick PASS fornisce la possibilità di gestire sia una white list sia una black list, è ovviamente possibile utilizzarle entrambe contemporaneamente. Tutti quegli istituti di credito che si desidera mostrare devono essere inseriti nella WhiteList. Se la WhiteList è vuota allora tutte le banche sono visibili. Nella BlackList tutti gli ASPSP inseriti saranno sempre mostrati, ma saranno indicati con il boolean isBlackListed a true. Tutte le operazioni eseguite sulle liste influenzeranno quindi le API correlate, come SearchBanks, GetBank e ValidateDebtor. Oltre agli istituti bancari, è anche possibile sfruttare le due liste per i servizi interni che alcune banche espongono (customerServices). Le seguenti configurazioni sono applicate a livello di Company (e non per singolo Service).
Update banks white list/black list
Utilizzando la API *UpdateBanksWhiteList-BlackLis * un FPP può aggiungere banche a una specifica lista:
PUT /api/fabrick/pass/v4.0/{serviceType}/{listType}/banks
{
"bankIds": [ {bankId}, {bankId}, {bankId}, … ]
}
Dove:
- serviceType: può essere impostato con access o initiate, a seconda dello scenario AISP o PISP; sempre initiate in questa guida.
- listType: white-lists, black-lists
- bankId: codice identificativo dell’istituto di credito.
{
"status": "OK"
}
L’insieme delle banche fornite in input viene confrontato con l’insieme delle banche già presenti nella lista, verrà aggiunto solo il delta. Ad esempio, se una lista è formata come segue: [3, 5, 7] e l’aggiornamento consiste nell’inserire le banche [2, 5, 8], solo le banche 2 e 8 verranno aggiunte alla lista, risultando quindi in: [2, 3, 5, 7, 8].
Update bank services white list / black list
Utilizzando la API UpdateBankServicesWhiteList-BlackList è possibile gestire eventuali customerServices di un ASPSP
PUT /api/fabrick/pass/v4.0/{serviceType}/{listType}/banks/{bankId}/services
{
"serviceIds": [ {serviceId}, {serviceId}, {serviceId}, … ]
}
Dove:
- serviceType: access | initiate, a seconda dello scenario
- listType: white-lists | black-lists
- bankId: codice identificativo dell’istituto di credito.
- serviceId: codice che identifica un determinato servizio offerto dalla banca. Il serviceId può essere recuperato dalla SearchBanks o dalla GetBank nell’oggetto "customerServices"
Read banks white list/black list
Tramite l’endpoint ReadBanksWhiteList-BlackList è possibile visualizzare le liste create:
GET /api/fabrick/pass/v4.0/{serviceType}/{listType}/banks
{
"status": "OK",
"payload": {
"list": [
{
"bankId": "19",
"gateway": "fabrick",
"createdDatetime": "2019-07-18T15:01:35.756+0000",
"deleted": false,
"businessName": "HYPE",
"labelName": "Hype",
"address": {
"city": "BIELLA",
"country": "ITALY",
"countryCode": "IT"
},
"fiscalCode": "22222222222",
"abiCode": "36772",
"bankNationalCodes": [
"36772"
],
"customerServices": [],
"media": [],
"bankConnector": "3",
"bankPisConnector": "101",
"uris": {
"sandbox": "https://sandbox-psdgw-hype.fabrick.com",
"live": "https://psdgw-hype.fabrick.com"
},
"aisLevel": 1,
"pisLevel": 1,
"scaFlows": [
"REDIRECT"
],
"supportedPayments": {
"single": {
"sepa": {
"standard": true,
"future": true,
"multiCurrency": false,
"delete": false
},
"instant": {
"standard": true,
"future": false,
"multiCurrency": false,
"delete": false
}
},
"recurring": {
"sepa": {
"standard": false,
"delete": false
}
}
},
"unstrRemittanceRestrictions": "CUSTOM",
"unstrRemittanceRegexp": "^[a-zA-Z0-9\\s,://'-]*$",
"aspspCapabilities": {
"providesAccountOwnerName": true
},
"isSupported": true,
"isOnline": true,
"lastUpdatedDatetime": "2020-11-13T14:39:31.373+0000",
"lastOnlineUpdatedDatetime": "2020-11-13T14:39:31.373+0000",
"isBlackListed": false
}
]
}
}
Read banks services white list/black list
Tramite l’endpoint ReadBankServicesWhiteList-BlackList sarà possibile visualizzare i dettagli delle due liste relative ai servizi:
GET /api/fabrick/pass/v4.0/{serviceType}/{listType}/banks
{
"status": "OK",
"payload": {
"list": [ <BankServiceModel> ]
}
}
Remove banks in banks white list/black list
Utilizzando l’endpoint RemoveBanksWhiteList-BlackList è possibile rimuovere una banca da una delle due liste.
DELETE /api/fabrick/pass/v4.0/{serviceType}/{listType}/banks/{bankId}
{
"status": "OK"
}
Remove banks services white list/black list
Utilizzando l’endpoint RemoveBanksWhiteList-BlackList è possibile rimuovere un servizio di una specifica banca da una delle due liste.
DELETE /api/fabrick/pass/v4.0/{serviceType}/{listType}/banks/{bankId}/services/{serviceId}
Clear banks white list/black list
L’endpoint ClearBanksWhiteList-BlackList consentirà di resettare la lista desiderata.
POST /api/fabrick/pass/v4.0/{serviceType}/{listType}/banks/clear
Clear banks services white list/black list
L’endpoint ClearBanksWhiteList-BlackList consentirà di resettare la lista desiderata.
POST /api/fabrick/pass/v4.0/{serviceType}/{listType}/banks/{bankId}/services/clear