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.