---
title: "Primi passi"
description: "Questo documento indica tutti i passaggi per poter provare il prodotto in pochi minuti."
url: "https://docs.fabrick.com/payment-institution/open-banking-and-psd2/psd2-introduction/getting-started/"
language: "it"
---

# 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*.