1. Embedded
Easypol pagoPA API
  • Getting Started
  • Payment API
    • Testing Data
    • Result Codes
    • Create Vehicle
      POST
    • Create Payment URL
      POST
    • Get Receipt
      GET
    • Verify PagoPA notice
      POST
  • Webhooks
    • Pagopa Payment Result
      POST
  • Embedded
    • Embedded Payments URL
      POST
  • Checkout
    • PagoPA Checkout
  • Schemas
    • Vehicle
    • PayableVehicleTax
    • PaidVehicleTax
    • ExternallyPaidVehicleTax
    • ExemptedVehicleTax
    • ErrorVehicleTax
    • UnknownVehicleTax
    • PayngVehicleTax
    • Inspection
  1. Embedded

Embedded Payments URL

POST
https://partners.easypol.io/api/v5/embedded/payments
Through this endpoint it is possible to generate an authenticated URL to be displayed in a WebView for a specific user.
The user is identified through the partnerUserId field, which is a unique identifier defined together with the partner.
If the call is successful, the response body contains a field named url, which includes the URL to be loaded in the WebView.
The URL must be loaded within 60 seconds from its creation. Once loaded, the session remains valid within the WebView until it is closed.
embedded_easypol.png

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://partners.easypol.io/api/v5/embedded/payments' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partnerUserId": "6787de494cbd7d976ddfb940"
}'
Response Response Example
{
    "url": "https://greatpartner.easypol.io/embedded/section?token=atoken"
}
Modified at 2026-02-17 14:43:29
Previous
Pagopa Payment Result
Next
PagoPA Checkout
Built with