Run with Postman
Documentation Powered by Redocly

Bollettini (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Web service that allows you to pay bills, mav, rav, pago pa and car tax.

First time here? Generate a new access token

Pay

Methods for handling payments

Bill payment request

Method that allows you to request a payment. The result will be a url that will redirect you to the payment portal.

Authorizations:
bearerAuth
    path Parameters
    endpoint
    required
    any
    Enum: 123 451 674 896 "rav" "mav" "pagopa" "bolloauto"

    Type of service requested

    Request Body schema: application/json
    One of
    email
    required
    string <email>
    Default: "<email>"

    customer email

    cognome
    string
    Default: "<string>"

    customer last name

    nome
    string
    Default: "<string>"

    customer first name

    indirizzo
    string
    Default: "<string>"

    customer address

    telefono
    string
    Default: "<string>"

    customer phone

    importo
    required
    number <= 2496.99
    Default: "<number>"

    amount to be paid

    cap
    string <= 5 characters
    Default: "<string>"

    customer zip code

    localita
    string
    Default: "<string>"

    customer town

    provincia
    string <= 2 characters
    Default: "<string>"

    customer province

    ccp
    required
    string <= 12 characters
    Default: "<string>"

    postal account

    causale
    required
    string
    Default: "<string>"

    causal

    object (Callback)

    Responses

    Response Schema: application/json
    object
    success
    boolean
    message
    string
    error
    integer

    Request samples

    Content type
    application/json
    Example
    123 - 451
    123 - 451
    674 - 896
    rav
    mav
    pagopa
    bolloauto
    {}

    Response samples

    Content type
    application/json
    {}

    All request

    Method that allows you to see all your payment requests.

    Authorizations:
    bearerAuth

      Responses

      Response Schema: application/json
      object (Get)
      success
      boolean
      message
      string
      error
      integer

      Request samples 

      CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pagasubito.it/pay/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

      Response samples

      Content type
      application/json
      {
      • "data": [
        ],
      • "success": true,
      • "message": "",
      • "error": null
      }

      Single request

      Method that allows you to see the single request identified by the id. The 'report' field is entered only after finalizing the payment and contains data on the outcome of the payment.

      Authorizations:
      bearerAuth
        path Parameters
        id
        required
        string
        Default: "<string>"
        Example: 64772d88496e98e849017aa8

        Request id

        Responses

        Response Schema: application/json
        Get123-451-674-896 (object) or Getmav-rav (object) or Getpagopa (object) or Getbolloauto (object)
        success
        boolean
        message
        string
        error
        integer

        Request samples 

        CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pagasubito.it/pay/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

        Response samples

        Content type
        application/json
        Example
        123-451
        123-451
        674-896
        mav
        rav
        pagopa
        bolloauto
        {
        • "data": [
          ],
        • "success": true,
        • "message": "",
        • "error": null
        }

        Get the receipt

        Method that allows you to download the receipt identified by the ID. If the receipt exists a pdf file is returned.

        Authorizations:
        bearerAuth
          path Parameters
          id
          required
          string
          Default: "<string>"
          Example: 64772d88496e98e849017aa8

          Request id

          Responses

          Response Schema: application/pdf
          string <binary>

          Request samples 

          CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pagasubito.it/pay/%7Bid%7D/ricevuta");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);