What is an IUPD in the PagoPA GPD API?

IUPD (Unique Identifier of Debt Position) is a globally unique identifier for a debt position, typically formatted as the organization fiscal code plus a UUID. It is the responsibility of the creditor entity (EC) to ensure uniqueness.

Can I update the IBAN for multiple debt positions at once?

Yes. Use PATCH /organizations/{organizationfiscalcode}/debtpositions/transfers with the oldIban query parameter and the newIban in the request body. This updates up to 1000 transfers in a single call.

How do I publish a debt position?

After creating a debt position in DRAFT state, call POST /organizations/{organizationfiscalcode}/debtpositions/{iupd}/publish to transition it to PUBLISHED, making it visible and payable in the pagoPA system.

Is the PagoPA GPD API free?

The PagoPA platform is provided by PagoPa S.p.A. for Italian public administrations. Access to the GPD API requires registration and approval from PagoPA. Pricing and terms are documented at www.pagopa.gov.it.

Can I mark a payment as paid if it was made outside pagoPA?

Yes. Use POST /organizations/{organizationfiscalcode}/paymentoptions/paids/{nav} with payment details to record an external payment, updating the debt position status to PAID or PARTIALLY_PAID.

Can I limit what my agent is allowed to do with the PagoPA GPD API?

Yes. Because Jentic One is self-hosted, your own rules decide which PagoPA GPD operations and credentials the agent may use. Since the API puts the organization fiscal code in the URL path, you can pin the agent to a single organization so it works within that entity and nothing else. You also choose the exact operations it may call, so you can allow creating and publishing debt positions while excluding destructive actions like deleting or invalidating a position unless you explicitly add them.