Skip to main content

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 una-tantum per mostrare la lista dei conti

Consente di effettuare la SCA (usa e getta) per accedere ai conti/carte in proprio possesso presso la banca, per il prodotto definito nel productId.

[POST] /{itemId}/consents/accountsList

Nella request in particolare abbiamo:

  • providerId* id della banca (o provider)
  • productCode* codice del prodotto
  • accountNature* natura dell'account ("account" o "card")
  • tppRedirectUri URL di redirect dopo che la SCA viene effettuata

Nella response l'API fornisce:

  • consentId id del consenso
  • consentStatus stato del consenso
  • scaManagerRedirectUrl URI per effettuare la SCA
  • validUntil data fine validità

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] /{itemId}/consents/recurring

Nella request in particolare abbiamo:

  • providerId* id della banca (o provider)
  • productCode* codice del prodotto
  • tppRedirectUri URL di redirect dopo che la SCA viene effettuata
  • 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 balances
  • accounts lista di oggetti con la stessa forma di balances

Nella response l'API fornisce:

  • consentId id del consenso
  • consentStatus stato del consenso
  • scaManagerRedirectUrl URI per effettuare la SCA
  • validUntil data fine validità

Rinnovo di un consenso

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

[PUT] /{itemId}/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 URI per effettuare la SCA
  • validUntil data fine validità

Revoca di un consenso

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

[DELETE] /{itemId}/consents/{consentId}

I parametri richiesti sono:

  • consentId path variable - id del consenso.

Nella response l'API torna il consenso stesso, con lo status aggiornato.

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] /{itemId}/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
Back to top