Consenso SCA

Effettuare una SCA

Descrizione

In questa sezione vengono elencati gli endpoint che consentono di ottenere e rinnovare i vari consensi necessari al collegamento di un conto.

Ottenimento consenso ricorrente

Consente di effettuare la SCA (valida tipicamente 90 giorni) per collegare ai conti/carte in proprio possesso presso la banca, per il prodotto selezionato.

[POST] /{itemUuid}/consents/recurring

Nella request in particolare abbiamo:

providerId^* id della banca (o provider)
productCode^* codice del prodotto
tppRedirectUri URI per effettuare la SCA
accountAccess^* oggetto composto da
- balances^* lista di oggetti con la seguente forma:
  - resourceId^*
  - iban
  - maskedPan
  - currency^*
  - accountNature
- transactions^* lista di oggetti con la stessa forma di accounts

Nella response l'API fornisce:

consentId id del consenso
consentStatus stato del consenso
scaManagerRedirectUrl commissioni totali della transazione
validUntil data fine validità

Rinnovo consenso

Consente di rinnovare la SCA (valida tipicamente 90 giorni) a partire da un consenso precedentemente valido.

[PUT] /{itemUuid}/consents/{consentId}/renew

I parametri richiesti sono:

consentId path variable - id del consenso.

Nella response l'API fornisce:

consentId id del consenso
consentStatus stato del consenso
scaManagerRedirectUrl commissioni totali della transazione
validUntil data fine validità

Recuperare i conti collegati ad un consenso

Consente di recuperare l'elenco dei conti/carte in proprio possesso presso la banca a fronte del consenso precedentemente fornito.

[GET] /{itemUuid}/consents/{consentId}/accounts

I parametri richiesti sono:

consentId path variable - id del consenso.

Nella response l'API fornisce:

accounts lista degli account composti dalle seguenti proprietà

accountId stato del consenso resourceId id della risorsa iban codice IBAN currency valuta di conto providerId id della banca productCode codice del prodotto consentId id del consenso