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 accounts

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