> For the complete documentation index, see [llms.txt](https://docs.pagopa.it/circolare-trimestrale/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagopa.it/circolare-trimestrale/inizia-da-qui/roadmap/opzioni-di-pagamento.md).

# Opzioni di pagamento

PagoPA ha messo a disposizione degli Enti Creditori (EC) una funzionalità che consente a chi deve pagare tramite un avviso, cioè attraverso canali e servizi di un PSP, la possibilità di usufruire, nel momento in cui deve pagare, di eventuali **opzioni di pagamento (OdP**).&#x20;

Nel caso in cui l’EC abbia previsto delle opzioni di pagamento e abilitato il servizio il PSP riceverà un set di informazioni aggiuntive, da mostrare al proprio cliente, che consentono di  gestire situazioni particolari come il pagamento di una specifica rata di un piano rateale a lungo termine, oppure la maggiorazione o la riduzione dell’importo facciale dell’avviso. Durante la fase di verifica di un pagamento che prevede  opzioni, l’EC fornisce al PSP da cui è partita la richiesta le informazioni che consentano al pagatore di effettuare una scelta tra varie possibili opzioni, modificando l’esperienza di pagamento.&#x20;

Grazie a questa nuova funzionalità, gli EC possono gestire il proprio archivio delle posizioni debitorie contemplando la possibilità di gestire le opzioni di pagamento che possono offrire al cittadino. Sarà quindi responsabilità dello stesso EC, fornire al pagatore, tutte le informazioni necessarie per operare scelte consapevoli al momento del pagamento.

{% embed url="<https://docs.pagopa.it/sanp/ente-creditore/opzioni-di-pagamento>" %}

## A quale esigenza rispondiamo?

La possibilità di avere a disposizione ulteriori opzioni di pagamento permetterà di soddisfare la crescente richiesta di gestione di *use case* da parte degli EC che presentano criticità con l’utilizzo del processo standard.

## Quale soluzione adottiamo?

Il nuovo servizio si comporta da *proxy* esponendo una API che i PSP possono invocare per verificare il pagamento e recuperare le OdP disponibili nell’ambito della stessa posizione debitoria. Il nuovo servizio gestisce internamente la configurazione necessaria per poter contattare l’endpoint esposto dagli EC, che dunque devono esporre un nuovo servizio.&#x20;

{% embed url="<https://docs.pagopa.it/sanp/ente-creditore/opzioni-di-pagamento>" %}

L’esposizione del servizio è in carico all’EC in caso di integrazione sincrona, o in carico a Gestione Posizioni Debitorie (GPD) in caso di integrazione asincrona.

## Impatti

Per gli EC che vogliono utilizzare la nuova funzionalità di OdP è necessario:

* 1\. configurare le stazioni per specificare se si supporta o meno il recupero delle opzioni di pagamento (per maggiori informazioni si rimanda al manuale utente del Backoffice al seguente [link](https://developer.pagopa.it/pago-pa/guides/manuale-bo-ec/readme/funzionalita/stazioni/configurazione-opzioni-di-pagamento));
* 2\. in caso di integrazione sincrona, configurare un nuovo endpoint REST per le stazioni che supportano le opzioni di pagamento;
* 3\. implementare la logica delle opzioni di pagamento secondo quanto descritto nei[ casi d'uso](https://docs.pagopa.it/sanp/ente-creditore/opzioni-di-pagamento/casi-duso).

## Perché è importante adeguarsi

Sebbene l'adesione al servizio sia facoltativa da parte dell'Ente Creditore è &#x20;

l'adeguamento  è importante poichè in grado di semplificare la gestione di determinati use case migliorando inoltre la qualità della relazione con l’Utente, garantendo  la possibilità di scegliere fra le diverse opzioni di pagamento rese disponibili,  ma anche semplificare i propri processi interni in fase di riconciliazione.&#x20;

L’adeguamento è altresì importante per i PSP che vogliono offrire ai propri clienti questa nuova opportunità.

## Serve supporto?

Per gli sviluppatori [è possibile aprire una issue su GitHub](https://github.com/pagopa/pagopa-api/issues).

Per altri chiarimenti suggeriamo di rivolgersi al team Service Management.

## Domande frequenti

### **Per i** PSP

#### Come sarà informato l’utente della disponibilità di più opzioni di pagamento?&#x20;

Sarà cura del PSP informare l’utente di questa possibilità.

### Per gli EC

#### **Chi valida le opzioni di pagamento?**

La validazione delle opzioni di pagamento è a carico dell’EC.

<br>


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.pagopa.it/circolare-trimestrale/inizia-da-qui/roadmap/opzioni-di-pagamento.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
