Pagamento bollettino tramite API ed in tempo reale

Servizio di pagamento disponibile per qualsiasi tipologia di bollettino

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.

Oas file url https://console.openapi.com/oas/it/bollettini.openapi.json
Fork or import with Postman
Production domain ws.pagasubito.it
Sandbox domain test.ws.pagasubito.it
Production Scopes 2
- GET ws.pagasubito.it/pay
- POST ws.pagasubito.it/pay
Sandbox Scopes 2
- POST test.ws.pagasubito.it/pay
- GET test.ws.pagasubito.it/pay

Bollettini (1.0.0)

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

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

Prima volta qui? Generare un nuovo token di accesso

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

123 - 451

{

"email": "[email protected]",
"importo": 123.12,
"ccp": "12324",
"causale": "string",
"callback": {
- "url": "https://your_domain.it/your_callback.php",
- "method": "POST",
- "field": "data",
- "headers": {
  - "session_id": "oiwejdf89453urf945jfg"
  }
}

}

Response samples

Content type

application/json

{

"data": {
- "id": "6489ca34bf95b3541e0ccb25",
- "payment_url": "https://test.ws.pagasubito.it/payment/6489ca34bf95b3541e0ccb25"
},
"success": true,
"message": "",
"error": null

}

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": [
- {
  - "id": "6481f66cf2129e73020e2e5d",
  - "type": "pagopa",
  - "importo": "",
  - "timestamp": "1686238828014"
  },
- {
  - "id": "6481f5cbd503bfa6cf061192",
  - "type": "mav",
  - "importo": "123.12",
  - "timestamp": "1686238667307"
  },
- {
  - "id": "6481f66cf2129e73020e2e5d",
  - "type": "rav",
  - "importo": "123.12",
  - "timestamp": "1686238526070"
  },
- {
  - "id": "6481f506b5fc59ab15049fe4",
  - "type": "896",
  - "importo": "123.12",
  - "timestamp": "1686238470629"
  }
],
"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

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

123-451

{

"data": [
- {
  - "id": "6481f4e11ca871c53c052bc1",
  - "cognome": "",
  - "nome": "",
  - "indirizzo": "",
  - "cap": "",
  - "localita": "",
  - "provincia": "",
  - "telefono": "",
  - "email": "[email protected]",
  - "importo": "12312",
  - "ccp": "218763",
  - "causale": "causal",
  - "type": "123",
  - "timestamp": "1686238433199",
  - "owner": "[email protected]",
  - "codice_bollettino": "",
  - "callback": {
    "url": "https://your_domain.it/your_callback.php",
    "headers": {
    "session_id": "9834thjf9fhj8907yf4"
    },
    "method": "POST",
    "field": "data",
    "data": { }
    },
  - "report": {
    "payment_status": "OK",
    "payment_id": "12020000340229",
    "email": "[email protected]",
    "payment_date": "2020-04-06 17:23:10",
    "total_amount": "126.12",
    "ccp": "218763",
    "bulletin_type": "123",
    "causal": "exemple causal",
    "operation_id": "111111",
    "code": ""
    }
  }
],
"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

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

}

Web Service Revision: 2.0.0