Passa al contenuto principale

API AISP – Documentazione Tecnica

Visualizza come Markdown

Le API AISP del Gateway PSD2 Fabrick consentono a un TPP accreditato di ottenere informazioni sui conti di pagamento del cliente (PSU), previo consenso. 

1. Gestione del Consenso​

Endpoint necessario a creare o aggiornare il consenso dell’utente per l’accesso ai dati dei conti.

Flusso generale​

  1. Il TPP richiede la creazione del consenso.

  2. La banca valuta se è necessario applicare SCA.

  3. Dopo la SCA, il consenso è attivo e utilizzabile. 

2. Recupero lista conti​

Permette di ottenere l’elenco dei conti raggiungibili.

Endpoint​

GET /v1/accounts

Descrizione​

Restituisce:

  • lista dei conti disponibili,

  • alias,

  • tipo di conto,

  • eventuali hyperlink alle risorse. 

3. Dettagli conto​

Endpoint per ottenere le informazioni di dettaglio di ciascun account.

GET /v1/accounts/{account-id} 

Include:

  • Tipo di conto

  • Nome

  • Iban/tokenizzazione

  • Informazioni aggiuntive rese disponibili dall’ASPSP

4. Lista transazioni​

Consente la lettura delle transazioni di un conto.

Endpoint​

GET /v1/accounts/{account-id}/transactions {query-parameters} 

Dati inclusi​

  • Movimenti eseguiti nel periodo richiesto

  • Possibili delta report

  • Gestione tokenizzata dell’account-id

5. Saldo conto​

Restituisce il saldo corrente di un conto specifico.

Endpoint​

GET /v1/accounts/{account-id}/balances 

Note di implementazione​

  • Ogni chiamata deve includere un certificato valido (QWAC) che identifichi il TPP.

  • Le banche possono differire nel supporto al delta report.

  • È richiesta SCA per alcune consultazioni, in base allo stato del consenso.

Riferimenti allo standard​

Le API seguono il framework Berlin Group NextGenPSD2 (v1.3).