Introduzione

Introduzione all'affiliazione

Il servizio Affiliations consente di associare il processo di onboarding di uno o più prodotti ad un soggetto (esterno) che presenta il prospect client a Fabrick per effettuare la sottoscrizione dei nuovi prodotti. L’affiliazione si basa sul rilascio di un Affiliation Code al soggetto affiliatore (es. MYCODE123), che tramite una apposita API può ottenere le redirect URL a cui i prospect client potranno trovare il processo di onboarding dedicato. Il servizio Affiliations prevede la possibilità di utilizzo con i servizi Carts e Offers per la gestione di modelli di carrello in cui è possibile precompilare:

• il set di prodotti da pre-inserire in carrello (con eventuali vincoli sulla selezionabilità ed eventuali dipendenze).
• il set di condizioni economiche previste per i prodotti preinseriti in carrello (eventualmente prevedendo anche eventuali alternative di scelta selezionabili a discrezione del cliente).

Ogni affiliatore può avere più Affiliation Code per prevedere differenti scenari di preselezione del carrello e/o delle relative offerte economiche.

Le funzionalità del servizio Affiliation possono essere complementate con il servizio Personification in modo da consentire il rilascio delle grant di personificazione al soggetto affiliatore direttamente nel processo di onboarding.

Use Case

Il servizio Affiliation è alla base di scenari in cui un soggetto esterno si fa promotore della vendita di prodotti/servizi Fabrick alla sua base clienti. Ad esempio una compagnia gestionale on line per le PMI potrà prevedere l’integrazione nella sua piattaforma delle funzionalità di Fabrick Pass Pay by Bank per permettere ai propri clienti l’incasso delle fatture mediante inizializzazione del pagamento direttamente dal conto dei debitori. In questo scenario, il gestionale richiede a Fabrick un link di redirect a cui direzionare i propri clienti, che troveranno quindi il processo di onboarding precompilato con il prodotto Pass Pay by Bank e le relative condizioni economiche. In questo caso il servizio Affiliation viene associato al servizio Personification in modo tale da rilasciare alla compagnia gestionale la grant di utilizzo in nome del cliente finale.

L'FPP che sviluppa il prodotto è chiamato affiliatore (TTPP o Soggetto Tecnico), mentre tutti gli altri FPP che utilizzano il servizio sono chiamati affiliati (o Concedenti o Grantor).

Tornado all'esempio precedente con il prodotto Pass Pay by Bank il vantaggio è che ogni FPP potrà offrire il prodotto Pay by Bank ai propri clienti e attivarli in modo completamente autonomo. Inoltre, per i clienti finali sarà completamente trasparente dal punto di vista tecnico, ovvero non sarà necessaria alcuna integrazione e/o sviluppo.

Di seguito è riportato un semplice diagramma esemplificativo:

L'apiKey dell'affiliatore FPP è abilitata solo per effettuare chiamate per la gestione del processo di affiliazione, mentre le apiKey degli affiliati saranno abilitate per effettuare chiamate per i prodotti contratualizzati, ad esempio Pass Pay by Bank e/o Pass AIS & PIS Services for Corporates.

Il diagramma precedente ha solo lo scopo di comprendere l'idea del flusso, in realtà le apiKey degli affiliati non sono visibili. Infatti, l'affiliato non vedrà alcuna apiKey all'interno del suo portale utente (ad eccezione ovviamente di altri prodotti al di fuori di quello di affiliazione).

L'affiliatore potrà creare tramite API un token per simulare il comportamento di ciascuna delle apiKey degli affiliati. I token generati hanno una durata limitata, vedremo i dettagli più avanti.

Ovviamente il TTPP potrebbe eventualmente avviare un processo di affiliazione su se stesso in modo da utilizzare anche i prodotti Pass realtivi ai pagamenti.

Obbligo contrattuale

Il contratto tra Fabrick e l'intermediario tecnico (il cosiddetto affiliatore) obbliga quest'ultimo a visualizzare la seguente dichiarazione di non responsabilità sulla propria piattaforma:

Fabrick S.p.A. è un istituto di pagamento autorizzato dalla Banca d’Italia ad operare quale Account Information Service Provider (“AISP”) e Payment Initiation Service Provider (“PISP”) ai sensi della Direttiva 2015/2366/(UE) sui servizi di pagamento nel mercato interno, come successivamente implementata ai sensi del diritto nazionale, iscritta all’Albo degli Istituti di Pagamento con decorrenza 16 marzo 2020 con il codice 36780.5. Il reindirizzamento al sito di Fabrick non determina l’insorgere di alcun impegno in capo ai potenziali Clienti alla sottoscrizione di un contratto avente ad oggetto i Servizi Fabrick

È quindi necessario che l'affiliato condivida con Fabrick le specifiche del metodo adottato per mostrare la suddetta dichiarazione di non responsabilità allegando uno screenshot.

Processo di affiliazione: panoramica

Il TTPP dovrà integrare le API descritte nel presente documento.

Il processo può essere suddiviso in 3 fasi:

• Subscription

• Verifica delle grants (opzionale)

• Richiesta di personalizzazione

Subscription

In questa fase il TTPP inviterà il proprio cliente a svolgere una fase di onboarding affinché possa diventare un concedente.

La fase di onboarding consiste in un modulo online in cui il cliente finale deve inserire le informazioni relative all'azienda e al titolare (o a un delegato). Tutti i passaggi in dettaglio sono indicati nel documento Affiliazione: guida per i concedenti

Verifica grants

Una volta completata la fase di onboarding, il TTPP dovrà verificare che quest'ultima sia stata completata con successo e correttamente. In particolare, dovrà anche verificare che il cliente abbia abilitato le autorizzazioni appropriate (grants) per il TTPP per consentirgli di procedere con la fase successiva e finale.

Questo passaggio è al momento facoltativo poiché le autorizzazioni vengono incluse automaticamente durante la fase di sottoscrizione.

Personification

Il servizio Personification abilità la funzionalità di personificazione tra utenti di piattaforma. Mediante un meccanismo di granting, tale funzione consente ad una utenza tecnica di utilizzare altri servizi o prodotti in nome e per conto del Consumer che li ha sottoscritti.

Il servizio Personification è fondamentale nella realizzazione di prodotti multi-tenant, abilitando la possibilità di impersonare il cliente sottoscrittore nell’utilizzo di altri moduli di piattaforma. Ad esempio, se un prodotto prevede la necessità di accesso alle API di Pass Pay by Bank, il servizio Personification consente al prodotto di consumare tali API senza necessariamente essere in possesso della APIKey del cliente; utilizzando infatti una opportuna grant concessa in fase di sottoscrizione, il prodotto può ottenere dinamicamente a runtime un token di personificazione che gli consente di “essere” a tutti gli effetti il cliente e di consumare in modo opportuno e sicuro le API di Pass Pay by Bank.

Dopo aver verificato di disporre delle autorizzazioni appropriate, il TTPP potrà effettuare richieste di personificazione, ovvero potrà utilizzare ad esempio i servizi Pisp personificando uno dei propri clienti (concedenti).

Questa è la fase in cui il TTPP, tramite API, otterrà un token da utilizzare come apiKey per invocare le API del prodotto contratualizzato. Ovviamente il token è collegato a un solo e unico concedente, in questo modo, dal punto di vista di Fabrick è come se le richieste HTTP arrivassero direttamente dal concedente.

Esempio

Supponiamo che un cliente abbia appena completato la fase di onboarding per il prodotto Pass Pay by Bank, abbia quindi completato la parte relativa all'abbonamento e abbia abilitato le concessioni appropriate. A questo punto, il TTPP sarà in grado di richiedere un token di personificazione associato a questo concedente.

Se, a questo punto, il TTPP richiama il POST SearchCreditors (prodotto Pass Pay by Bank standard) inserendo il token sopra menzionato nell'intestazione, otterrà in risposta il conto o i conti di credito del concedente1.

Se in un secondo momento il TTPP richiama il POST SearchCreditors inserendo nell'intestazione un nuovo token generato tramite API e relativo al concedente, otterrà in risposta il conto o i conti di credito del concedente.

Non sarà quindi possibile recuperare i conti di credito di tutti i propri concedenti tramite una singola chiamata.