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

      Nella request in particolare abbiamo:

      • providerId* id della banca (o provider)
      • productCode* codice del prodotto
      • tppRedirectUri URIURL perdi effettuareredirect 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 commissioni totaliURI dellaper transazioneeffettuare la SCA
      • 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 totaliURI dellaper transazioneeffettuare la SCA
      • 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
      Back to top