Easypol pagoPA API
    Easypol pagoPA API
    • Getting Started
    • Payment API
      • Testing Data
      • Result Codes
      • Create Vehicle
        POST
      • Create Payment URL
        POST
      • Get Receipt
        GET
    • Webhooks
      • Pagopa Payment Result
        POST
    • Schemas
      • Vehicle
      • PayableVehicleTax
      • PaidVehicleTax
      • ExternallyPaidVehicleTax
      • ExemptedVehicleTax
      • ErrorVehicleTax
      • UnknownVehicleTax
      • PayngVehicleTax
      • Inspection

    Getting Started

    This guide provides all the information you need to integrate our PagoPA payment services into your applications or websites.
    With Easypol, you can simplify the payment process for a variety of public services and private utilities, including vehicle taxes and PagoPA notices.

    Features#

    Verification of PagoPA notice data
    Verification of ACI vehicle tax data (car, motorcycle, or trailer)
    Payment of a PagoPA notice or ACI vehicle tax

    Supported Payment Methods#

    Visa
    Mastercard
    Google Pay
    Apple Pay
    PayPal (coming soon)

    Authentication#

    All API calls must be authenticated by providing an API key in the x-api-key header.
    💡
    Don't have an API key?
    Contact us at partners@easypol.io to request access to our services.

    Environments#

    We have two separate environments: Production and Alpha (testing).
    Refer to the Testing Data section for more details about the test environment.
    Production: https://partners.easypol.io/api/v5
    Alpha: https://alpha.partners.easypol.io/api/v5

    Error Handling#

    The possible HTTP status codes returned in case of errors are:
    400: The request is in an invalid state
    401: The request is not authenticated
    422: The data sent in the request is invalid
    500: An internal server error occurred
    In all error cases, the response body includes a message providing more details about the cause:
    {
      "message": "Invalid notice number"
    }
    Modified at 2025-10-16 21:01:10
    Next
    Testing Data
    Built with