Bollettini

Pagamento bollettino tramite API ed in tempo reale

Servizio di pagamento disponibile per qualsiasi tipologia di bollettino

Tutte le informazioni di cui hai bisogno

Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.

Utili consigli per iniziare con Bollettini

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.

Bollettini (1.0.0)

Servizio web che consente di pagare bollette, mav, rav, pago pa e bollo auto.

Pay

Metodi di gestione dei pagamenti

Richiesta di pagamento della bolletta

Metodo che consente di richiedere un pagamento. Il risultato sarà un url che reindirizzerà l'utente al portale dei pagamenti.

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

Tipo di servizio richiesto

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

e-mail del cliente

cognome
string

cognome del cliente

nome
string

nome del cliente

indirizzo
string

indirizzo del cliente

telefono
string

telefono cliente

importo
required
number <= 2496.99

importo da pagare

cap
string <= 5 characters

codice postale del cliente

localita
string

città cliente

provincia
string <= 2 characters

provincia del cliente

ccp
required
string <= 12 characters

conto corrente postale

causale
required
string

causale

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
{}

Tutte le richieste

Metodo che consente di visualizzare tutte le richieste di pagamento.

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
}

Richiesta singola

Metodo che consente di visualizzare la singola richiesta identificata dall'id. Il campo "report" viene inserito solo dopo aver finalizzato il pagamento e contiene i dati relativi all'esito del pagamento.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 64772d88496e98e849017aa8

Id della richiesta

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
}

Ottenere la ricevuta

Metodo che consente di scaricare la ricevuta identificata dall'ID. Se la ricevuta esiste, viene restituito un file pdf.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 64772d88496e98e849017aa8

Id della richiesta

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
}