Paying Bills

Bills payment via API and in real time

Payment service available for any type of bill

All the knowledge you need

Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.

Useful tips to start with Paying Bills

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.

Bollettini (1.0.0)

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

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>

customer email

cognome
string

customer last name

nome
string

customer first name

indirizzo
string

customer address

telefono
string

customer phone

importo
required
number <= 2496.99

amount to be paid

cap
string <= 5 characters

customer zip code

localita
string

customer town

provincia
string <= 2 characters

customer province

ccp
required
string <= 12 characters

postal account

causale
required
string

causal

object (Callback)

Responses

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

Request samples

Content type
application/json
Example
{}

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
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
{
  • "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
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);

Response samples

Content type
application/json
{
  • "success": false,
  • "message": "invalid id",
  • "error": 234,
  • "data": null
}