> 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/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-pagamenti-associati-al-servizio/personalizzare-la-causale-di-pagamento.md).

# Personalizzare la causale di pagamento

{% hint style="info" %}
La causale di pagamento è normalmente composta dall'identificativo della pratica e dal codice fiscale del richiedente.
{% endhint %}

Per personalizzare il valore della causale di pagamento, inserisci un [campo *text field*](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-textfield.md) e attiva la [funzione *hidden*](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/le-funzioni/nascondere-i-componenti.md#usare-la-funzione-hidden).

Nella sezione API del componente, alla voce "Property Name" inserisci "payment\_description".

<figure><img src="/files/ABEL4iochHvbNRC6I20k" alt=""><figcaption></figcaption></figure>

Indica il numero massimo di caratteri alla voce "Maximum Length" della sezione "Validation".

<figure><img src="/files/bT7TFDwhTZ1tnH6hqeUQ" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Il limite varia a seconda dell'intermediario di pagamento integrato: ad esempio, MyPay prevede un limite di 60 caratteri, per evitare che la causale venga troncata all'interno dell'avviso di pagamento pdf
{% endhint %}

Successivamente, disattiva la funzione "Clear value when hidden" nella sezione "Data" (1) e alla voce "Calculated value" inserisci il codice JavaScript di personalizzazione della causale (2).

<div><figure><img src="/files/bd6Nxpc8I5Br0tty5uwA" alt=""><figcaption></figcaption></figure> <figure><img src="/files/skctWSX6Pz9VLqmrz7yR" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Ad esempio, in un servizio di richiesta di sepoltura di un defunto, puoi configurare la causale di pagamento in modo tale che, se il richiedente è un parente, riporti nome e cognome del richiedente; in tutti gli altri casi, deve riportare nome e cognome sia del richiedente sia del beneficiario.
{% endhint %}

```javascript
if (["parente"].includes(data.for_whom)) {
  value = `Diritti di segreteria per l'autorizzazione alla sepoltura per ${data.applicant.data.completename.data.name} ${data.applicant.data.completename.data.surname}`
} else {
  value = `Diritti di segreteria per l'autorizzazione alla sepoltura di ${data.applicant.data.completename.data.name} ${data.applicant.data.completename.data.surname} per ${data.beneficiary.data.given_name} ${data.beneficiary.data.family_name}`
}
```

Eventualmente, puoi inserire la causa personalizzata nel campo "Default value" della sezione "Data".

<figure><img src="/files/qcJ4dhWB2tuuODXNGxGE" alt=""><figcaption></figcaption></figure>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opencityitalia.it/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-pagamenti-associati-al-servizio/personalizzare-la-causale-di-pagamento.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.