Primi passi

Questo documento indica tutti i passaggi per poter provare il prodotto in pochi minuti.

Per iniziare, è necessario avere a portata di mano l’indice della documentazione, poiché verranno richiamati i singoli documenti.

Ottieni la tua apiKey privata

Apri il documento Fabrick Consumer Portal:

• Login: sezione 1
• Leggi il valore dell’apiKey: sezione 8
• Imposta gli intervalli IP da abilitare: sezione 8.3

Verifica la configurazione

Utilizzando la demo (solo per Pass)

Apri la demo (sezione Demo nel documento) e inserisci il valore dell’apiKey nella sezione ApiKeys Mng nel campo di input in base al prodotto interessato.

La demo utilizza esattamente le stesse API che dovranno essere utilizzate dall’FPP; sarà quindi possibile completare l’intero flow per ciascun prodotto: aggregare conti e visualizzare le informazioni, calcolare lo smartScore oppure effettuare pagamenti e verificarne l’esito.

Inoltre, aprendo la developer console (tab network) sarà possibile vedere tutte le richieste HTTP effettuate: in questo modo può essere utilizzata anche come banco di prova durante la fase di sviluppo.

Utilizzando Postman

Grazie alle collezioni Postman sarà possibile verificare che la fase di setup sia completata correttamente e quindi provare le API.

I domini di PRE e PRO sono indicati nella sezione Domains; sarà inoltre necessario inserire il valore dell’apiKey tra le variabili.

Sandbox accounts delle banche

Per concludere un test, sia esso di account aggregation o di pagamento, sarà necessario autenticarsi con la banca scelta. Per utilizzare questi account, fare riferimento al file excel Sandbox accounts e al documento Sandbox accounts description.

Richiesta supporto

Vedi documento Fabrick Setup, sezione Service Desk Support.

è necessario registrare il correlationId e condividerlo con Fabrick per ottenere un supporto più efficace

Integrazione

Una volta completata la fase di "getting started", sarà possibile vedere i dettagli delle varie API esplorando il resto della documentazione.

Cerchiamo di mantenere la documentazione il più completa e aggiornata possibile, ma per qualsiasi necessità il nostro team è a completa disposizione.

Errori più comuni

Error Code	Error Description	Solution
GTW003	Api key not found	Il valore dell’apiKey è errato: a) verificare la correttezza b) verificare eventuali spazi a inizio/fine stringa c) verificare di non aver invertito le apiKey di pre-produzione e produzione
GTW012	Ip not in range	L’indirizzo IP da cui parte la richiesta non è tra quelli abilitati (vedi punto 3 della sezione Ottieni la tua apiKey privata)
GTW915	Not granted to perform the operation	L’apiKey utilizzata non è abilitata a effettuare la richiesta. Verificare di utilizzare la product key corretta.
GTW024	Consumer not found	L’apiKey non ha le configurazioni corrette. Verificare di utilizzare la product key corretta.

Error Code	Error Description	Solution
PSD2_xxx	[various genre]	Errore restituito dalla banca finale. Contattare Fabrick che inoltrerà il problema al gateway competente
WOPxxx	[various genre]	Errore lato Fabrick, ad esempio configurazioni di setup non impostate correttamente

In caso di ulteriore supporto vedi sezione Richiesta supporto.