PagoPA Payment Options Resource API

The Payment Options Resource API from PagoPA — 1 operation(s) for payment options resource.

GitHub OpenAPI

Operations 1

POST /payment-options/organizations/{organization-fiscal-code}/notices/{notice-number} Get payment options by noticeNumber #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/pagopa:pagopa-payment-options-resource-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pagopa-payment-options-resource-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: pagoPA Payment Options for Organizations Payment Options…
  description: 'pagoPA Payment Options service for Organizations

    * `INFO` This is the specification that creditor institutions must implement for the payment options service

    ### APP ERROR CODES ###


    Details

    **NAME** | **HTTP STATUS CODE** | **DESCRIPTION**

    - | - | -

    **ODP-101** | *400 Bad Request* | PAA_SINTASSI Custom error description

    **ODP-102** | *422 Unprocessable Entity* | PAA_SEMANTICA Custom error description

    **ODP-103** | *500 Internal Server Error* | PAA_SYSTEM_ERROR Custom error…'
  termsOfService: https://www.pagopa.gov.it/
  version: 0.7.0
servers:
- url: http://api.platform.it/service/v1
  description: Production base URL
tags:
- name: Payment Options Resource
paths:
  /payment-options/organizations/{organization-fiscal-code}/notices/{notice-number}:
    post:
      tags:
      - Payment Options Resource
      summary: Get payment options by noticeNumber
      description: Returns payment options for a given notice and organization
      operationId: getPaymentOptionsByNoticeNumber
      parameters:
      - name: notice-number
        in: path
        required: true
        schema:
          type: string
      - name: organization-fiscal-code
        in: path
        required: true
        schema:
          type: string
      responses:
        '500':
          $ref: '#/components/responses/ErrorResponse500'
        '400':
          $ref: '#/components/responses/ErrorResponse400'
        '404':
          $ref: '#/components/responses/ErrorResponse404'
        '409':
          $ref: '#/components/responses/ErrorResponse409'
        '422':
          $ref: '#/components/responses/ErrorResponse422'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentOptionsResponse'
              example:
                organizationFiscalCode: '99999000013'
                companyName: EC
                officeName: EC
                paymentOptions:
                - description: Test PayOpt - Opzione 1 - Soluzione Unica
                  numberOfInstallments: 1
                  amount: 120
                  dueDate: '2024-10-30T23:59:59'
                  validFrom: '2024-09-30T23:59:59'
                  status: non pagato
                  statusReason: desc
                  allCCP: false
                  installments:
                  - nav: '311111111111111116'
                    iuv: '311111111111111116'
                    amount: 120
                    description: Test Opt Inst - soluzione unica
                    dueDate: '2024-10-30T23:59:59'
                    validFrom: '2024-09-30T23:59:59'
                    status: non pagato
                    statusReason: desc
components:
  responses:
    ErrorResponse422:
      description: Default app exception for status 422
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            UnprocessableEntityExample:
              value:
                httpStatusCode: 422
                httpStatusDescription: Unprocessable Entity
                appErrorCode: ODP-110
                timestamp: 1724425035
                dateTime: '2024-08-23T14:57:15.635528'
                errorMessage: PAA_PAGAMENTO_SCADUTO Errore per pagamento scaduto
    ErrorResponse409:
      description: Default app exception for status 409
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            ConflitExample:
              value:
                httpStatusCode: 409
                httpStatusDescription: Conflict
                appErrorCode: ODP-108
                timestamp: 1724425035
                dateTime: '2024-08-23T14:57:15.635528'
                errorMessage: PAA_PAGAMENTO_DUPLICATO Errore per pagamento duplicato
    ErrorResponse500:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            InternalServerErrorExample:
              value:
                httpStatusCode: 500
                httpStatusDescription: Internal Server Error
                appErrorCode: ODP-103
                timestamp: 1724425035
                dateTime: '2024-08-23T14:57:15.635528'
                errorMessage: PAA_SYSTEM_ERROR Errore generico
    ErrorResponse400:
      description: Default app exception for status 400
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            BadRequestExample:
              value:
                httpStatusCode: 400
                httpStatusDescription: Bad Request
                appErrorCode: ODP-101
                timestamp: 1724425035
                dateTime: '2024-08-23T14:57:15.635528'
                errorMessage: PAA_SINTASSI Errore di sintassi del modello nella richiesta
    ErrorResponse404:
      description: Default app exception for status 404
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            NotFoundExample:
              value:
                httpStatusCode: 404
                httpStatusDescription: Not Found
                appErrorCode: ODP-107
                timestamp: 1724425035
                dateTime: '2024-08-23T14:57:15.635528'
                errorMessage: PAA_PAGAMENTO_SCONOSCIUTO Errore per pagamento sconosciuto
  schemas:
    EnumPo:
      enum:
      - PO_UNPAID
      - PO_PAID
      - PO_PARTIALLY_PAID
      - PO_EXPIRED_NOT_PAYABLE
      - PO_EXPIRED_UNPAID
      - PO_INVALID
      type: string
    EnumInstallment:
      enum:
      - POI_UNPAID
      - POI_PAID
      - POI_EXPIRED_NOT_PAYABLE
      - POI_EXPIRED_UNPAID
      - POI_INVALID
      type: string
    ErrorResponse:
      type: object
      properties:
        httpStatusCode:
          format: int32
          type: integer
          example: 500
        httpStatusDescription:
          type: string
          example: Internal Server Error  (HTTP Status Code reference according to https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status)
        errorMessage:
          type: string
          example: An unexpected error has occurred. Please contact support.
        appErrorCode:
          type: string
          example: ODP-<ERR_ID>
        timestamp:
          format: int64
          type: integer
          example: 1724425035
        dateTime:
          type: string
          example: '2024-08-23T14:57:15.635528'
    PaymentOptionsResponse:
      type: object
      properties:
        organizationFiscalCode:
          type: string
        companyName:
          type: string
        officeName:
          type: string
        standin:
          type: boolean
        paymentOptions:
          type: array
          items:
            $ref: '#/components/schemas/PaymentOption'
    Installment:
      type: object
      properties:
        nav:
          type: string
        iuv:
          type: string
        amount:
          format: int64
          type: integer
        description:
          type: string
        dueDate:
          type: string
          format: date-time
        validFrom:
          type: string
          format: date-time
        status:
          $ref: '#/components/schemas/EnumInstallment'
        statusReason:
          type: string
    PaymentOption:
      type: object
      properties:
        description:
          type: string
        numberOfInstallments:
          format: int32
          type: integer
        dueDate:
          type: string
          format: date-time
        validFrom:
          type: string
          format: date-time
        amount:
          format: int64
          type: integer
        status:
          $ref: '#/components/schemas/EnumPo'
        statusReason:
          type: string
        allCCP:
          type: boolean
        installments:
          type: array
          items:
            $ref: '#/components/schemas/Installment'
  securitySchemes:
    ApiKey:
      type: apiKey
      name: Ocp-Apim-Subscription-Key
      in: header