Tabella dei contenuti

Attributi

service_name


Descrizione	Nome del servizio visualizzato in app
Tipo	Stringa
Obbligatorio	Sì

organization_name


Descrizione	Nome dell'ente che eroga il servizio
Tipo	Stringa
Obbligatorio	Sì

organization_fiscal_code


Descrizione	Codice Fiscale dell’ente che eroga il servizio
Tipo	Stringa
Obbligatorio	Sì

department_name


Descrizione	Nome del dipartimento dell’ente che eroga il servizio
Tipo	Stringa
Obbligatorio	Sì

authorized_cidrs

Di default non sono applicate restrizioni. È obbligatorio inserire le restrizioni IP prima del passaggio in produzione.


Descrizione	Lista IP/subnet autorizzate per richiamare il servizio
Tipo	Lista di stringhe
Obbligatorio	Sì

is_visible

In fase di test, è importante impostare il valore in**false**.


Descrizione	Flag che modifica la visibilità del servizio in app
Tipo	Booleano
Obbligatorio	Sì

max_allowed_payment_amount


Descrizione	Importo massimo autorizzato nei messaggi che contengono un avviso di pagamento pagoPA. L’importo è inteso in centesimi di euro, cioè come parte intera più due cifre decimali. Per esempio, per impostare una soglia di pagamento di 1500,00 € bisogna inserire il valore 150000
Tipo	Intero
Obbligatorio	Sì, se il servizio prevede l’invio di avvisi di pagamento pagoPA

version

Questo campo è automaticamente gestito dall’infrastruttura di IO ed è considerato in sola lettura.


Descrizione	Numero di versione del servizio
Tipo	No
Obbligatorio	Intero

require_secure_channels


Descrizione	Flag che permette di anonimizzare le notifiche inviate agli utenti (push e email). Il valore predefinito è false 🔔 Notifica Push Se true, il contenuto è generico: "Hai un nuovo messaggio" ✉ Email Se true, non viene inviata alcuna email, a prescindere dalle preferenze dell'utente.
Tipo	Booleano
Obbligatorio	No

service_id

Questa proprietà non è modificabile ed è considerata in sola lettura.


Descrizione	Identificativo del servizio. È il riferimento da usare come parametro nel path della richiesta per invocare i servizi come Update Service e Upload Service Logo
Tipo	Stringa

id

Questa proprietà non è modificabile ed è considerata in sola lettura.

Questa proprietà non va inviata nelle request e sarà aggiornata in automatico ad ogni modifica del servizio.


Descrizione	Identificativo versionato del servizio: è la composizione di "service_id"+"version" con zero fill
Tipo	Stringa

authorized_recipients

Alla creazione di un servizio, è possibile inviare messaggi soltanto al cittadino di test con Codice Fiscale AAAAAA00A00A000A. Questa restrizione non si applica agli utenti abilitati all’invio a qualsiasi Codice Fiscale.


Descrizione	Lista dei Codici Fiscali a cui il servizio può inviare messaggi
Tipo	Lista di stringhe
Obbligatorio	No

primary_key


Descrizione	Chiave primaria del servizio da inviare nell’header Ocp-Apim-Subscription-Key. Chiave primaria e secondaria sono equivalenti e vengono duplicate per cambiarle senza interrompere il servizio
Tipo	stringa
Obbligatorio	n.a.

secondary_key


Descrizione	Chiave secondaria del servizio da inviare in alternativa alla chiave primaria nell’header Ocp-Apim-Subscription-Key. Chiave primaria e secondaria sono equivalenti e vengono duplicate per cambiarle senza interrompere il servizio
Tipo	stringa
Obbligatorio	n.a.

Non hai ancora completato l’onboarding e hai bisogno di aiuto?

Scrivi un’email in cui descrivi il tuo problema o dubbio all’indirizzo areariservata@assistenza.pagopa.it.

Hai bisogno di aiuto su API e Integrazione?

Scrivi un’email in cui descrivi il tuo problema o dubbio all’indirizzo:

io‑service‑management@pagopa.it

Dicci cosa ne pensi

Per segnalare problemi o dare feedback, lascia un commento nello spazio Github dell'app IO

IO, l’app dei servizi pubblici