Merchant's Credentials
Revenue Agency’s merchants credentials
To access the Revenue Agency’s "Online Commercial Document" web procedure through the SIGN IT API lite, merchants must have personal Fisconline credentials. These credentials can be obtained by all taxpayers over the age of 16, including Italian citizens residing abroad, who possess an Italian VAT number.
SIGN IT API allows the input of Fisconline credentials through the fiscalization section of the createTaxpayer and the updateTaxpayer endpoints. The password, pin tax_id_number of the Fisconline user need to be provided for the specific Taxpayer (COMPANY or INDIVIDUAL). Please keep in mind that the end user will need an interface through which they can periodically update their credentials.
The SIGN IT API supports authentication and submission of fiscal commercial documents to AdE's web portal exclusively using Fisconline credentials. These credentials expire every 90 days (we recommend renewing them every 60 days). Other authentication methods, such as SPID, are not supported as they would require renewal every 24 hours.
The password expires periodically. Merchants are required to regularly update their credentials online every 60 days and submit them via SIGN IT lite. Learn how in this article: SIGN IT - How to update the FISCONLINE credentials
Using credentials that are no longer valid will lead to service disruption, as the SIGN IT lite API will be unable to authenticate with the web procedure. For this reason, it is recommended to implement a periodic reminder for merchants (e.g. via email) to avoid issues such as the blocking of transaction data transmission.
The taxpayer must manually do an initial log in to the Revenue Agency’s web portal in order to ensure that the credentials work properly and to accept the terms, conditions and additional clauses provided.
How to request Fisconline credentials?
The natural person acting as a self-employed individual or as the legal representative of a business can request Fisconline credentials from the Revenue Agency. The easiest way to obtain the credentials for the first time is by submitting a request in person at a Revenue Agency office. For this, the Italian Fiscal Code of the individual or the company will be required.
For a detailed Merchant Guide on how to request Fisconline credentials, please contact our sales team.
A new password must be set after the first login. The password provided by the Revenue Agency for initial access should not be used in the SIGN IT API.
Find more information through the FAQs of the Revenue Agency