> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-pagamenti-associati-al-servizio/integrare-un-servizio-digitale-con-i-pagamenti.md).
# Integrare un servizio digitale con i pagamenti
## Accedi alla sezione "Pagamenti" del servizio
Collocati nella sezione "Pagamenti" del servizio che stai configurato e seleziona il tuo intermediario di pagamento.
{% hint style="info" %}
Se deselezioni l'intermediario di pagamento, tutte le configurazioni di pagamento associate al servizio vengono rimosse automaticamente. Il cittadino non vedrà alcuna richiesta di pagamento durante la compilazione.
{% endhint %}
Una volta fatto puoi:
* aggiungere uno o più pagamenti immediati;
* aggiungere uno o più pagamenti posticipati.
## Aggiungere pagamenti
Per inserire uno o più pagamenti, clicca su "Aggiungi"
In entrambi i casi, si aprirà una schermata in cui devi indicare:
* il tipo di dovuto;
* l'importo;
* la causale;
* i giorni di validità del pagamento;
* la categoria (secondo la tassonomia ufficiale di pagoPA).
## Modificare i pagamenti
Clicca sul nome del pagamento che hai inserito in precedenza per modificarlo.
## Eliminare i pagamenti
Clicca sul tasto "Elimina" per cancellare un pagamento inserito.
## Configurare il bilancio
Durante [l'aggiunta](#aggiungere-pagamenti) o la [modifica](#modificare-i-pagamenti) di un pagamento, clicca su "Aggiungi bilancio" per inserire una o più configurazioni di bilancio.
{% hint style="info" %}
Le voci di bilancio da configurare variano in base all'intermediario di pagamento integrato.
{% endhint %}
Per ogni voce di bilancio è necessario specificare i seguenti campi:
* **ID** (obbligatorio): identificativo univoco della voce di bilancio. Testo libero.
* **Capitolo** (obbligatorio): capitolo di bilancio associato alla voce.
* **Ufficio**: ufficio di riferimento della voce di bilancio.
* **Accertamento**: accertamento associato alla voce di bilancio.
* **Importo** (obbligatorio): importo della voce di bilancio. NB: la somma degli importi delle voci DEVE equivalere all'importo totale.
### Pagamento dinamico e bilancio
Se all’interno del modulo è presente un componente di calcolo, come [`payment_amount`](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-pagamenti-associati-al-servizio/configurare-un-importo-dinamico), che calcola l’importo in base alle scelte effettuate dall’utente, per configurare il bilancio è necessario aggiungere un apposito componente Hidden all’interno del modulo.\
\
Inserire un componente Hidden e impostare:
* Property Name: `payment_financial_report`
* Calculated Value: inserire una funzione JavaScript come quella riportata nell’esempio seguente. La funzione deve assegnare alla variabile `value` un oggetto le cui chiavi corrispondono agli ID delle voci di bilancio.
{% hint style="info" %}
[La somma degli importi dei componenti del bilancio deve essere uguale al valore di `payment_amount` specificato.](#user-content-fn-1)[^1]
{% endhint %}
Esempio di codice JavaScript:
```
if (data.lost === true) {
value = {
"c_1": "0.25",
"c_2": "10.32",
"c_3": "16.79",
}
} else {
value = {
"c_1": "0.25",
"c_2": "5.16",
"c_3": "16.79",
}
}
```
In questo esempio `data.lost` è il valore di un componente del form con Property Name `lost`. In base alla scelta dell'utente, viene calcolato l'importo corrispondente per ciascuna voce di bilancio (`c_1`, `c_2`, `c_3`), mantenendo la somma coerente con `payment_amount`
\
Esempio della configurazione del bilancio nel tab Pagamenti corrispondente al codice JavaScript.\
La chiave di ogni elemento dell’oggetto, ad esempio `c_1`, `c_2` e `c_3`, deve corrispondere all’ID specificato durante la configurazione del bilancio.
[^1]:
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-pagamenti-associati-al-servizio/integrare-un-servizio-digitale-con-i-pagamenti.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
