Getting started

This document indicates all the steps to be able to try the product in just a few minutes.

To start, it is necessary to have the index of the documentation at hand since reference will be made to the single documents.

Get your private apiKey

Open the document Fabrick Consumer Portal:

• Login: section 1
• Read the value of the apiKey: section 8
• Set the IP ranges to be enabled: section 8.3

Check the setup

Using demo (only for Pass)

Open the demo (Demo section in the document) and enter the apiKey value in the ApiKeys Mng section in the input box depending on the product surveyed.

The demo uses exactly the same APIs that will have to be used by the FPP, it will therefore be possible to complete the entire flow for each product: aggregate accounts and view their information, calculate the smartScore or make payments and check the outcome.

Furthermore, by opening the developer console (network tab) it will be possible to see all the HTTP requests made: in this way it can also be used as a test bench during the development phase.

Using Postman

Thanks to the postman collections it will be possible to verify that the setup phase is completed correctly and then try the APIs.

The domains of PRE and PRO are indicated in the Domains section, it will also be necessary to insert the value of the apiKey among the variables.

Banks sandbox accounts

To conclude a test, be it account aggregation or payment, it will be necessary to authenticate with the chosen bank. To use these accounts, refer to the Sandbox accounts excel file and the Sandbox accounts description document.

Request support

See document Fabrick Setup, section Service Desk Support.

it is necessary to log the correlationId and share it with Fabrick to obtain more effective support

Integration

Once the "getting started" phase is complete, it will be possible to see the details of the various APIs by exploring the rest of the documentation.

We try to keep the documentation as complete and up-to-date as possible, but for any need our team is at your complete disposal.

Most common errors

Error Code	Error Description	Solution
GTW003	Api key not found	The apiKey value is incorrect: a) check for correctness b) check for any spaces at the beginning or end of the string c) Verify that you have not inverted the pre-production and production apiKeys
GTW012	Ip not in range	The IP address from which the request starts is not among those enabled (see point 3 of the Get your private apiKey section
GTW915	Not granted to perform the operation	The apiKey being used is not enabled to make the request. Verify that you are using the correct product key.
GTW024	Consumer not found	the apiKey does not have the correct configurations. . Verify that you are using the correct product key.

Error Code	Error Description	Solution
PSD2_xxx	[various genre]	Final bank returned error. Contact Fabrick who will forward the problem to the competent gateway
WOPxxx	[various genre]	Fabrick side error, for example setup configuration not set correctly

In case you need further support v Request Support section