Passa al contenuto principale

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