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.
Prendi il token nell'apposita sezione prima di cominciare.
- 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
-
Sandbox Scopes 2
- POST test.ws.pagasubito.it/pay
- GET test.ws.pagasubito.it/pay
Bollettini (1.0.0)
Servizio web che consente di pagare bollette, mav, rav, pago pa e bollo auto.
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:
path Parameters
endpoint required | any Enum: 123 451 674 896 "rav" "mav" "pagopa" "bolloauto" Tipo di servizio richiesto |
Request Body schema: application/json
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "importo": 123.12,
- "ccp": "12324",
- "causale": "string",
- "callback": {
- "method": "POST",
- "field": "data",
- "headers": {
- "session_id": "oiwejdf89453urf945jfg"
Response samples
- 200
- 400
- 404
- 406
- 428
- "data": {
- "id": "6489ca34bf95b3541e0ccb25",
- "success": true,
- "message": "",
- "error": null
Tutte le richieste
Metodo che consente di visualizzare tutte le richieste di pagamento.
Authorizations:
Responses
Response Schema: application/json
object (Get) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 404
- "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:
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
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 400
- 404
- "data": [
- {
- "id": "6481f4e11ca871c53c052bc1",
- "cognome": "",
- "nome": "",
- "indirizzo": "",
- "cap": "",
- "localita": "",
- "provincia": "",
- "telefono": "",
- "importo": "12312",
- "ccp": "218763",
- "causale": "causal",
- "type": "123",
- "timestamp": "1686238433199",
- "codice_bollettino": "",
- "callback": {
- "headers": {
- "session_id": "9834thjf9fhj8907yf4"
- "method": "POST",
- "field": "data",
- "data": { }
- "report": {
- "payment_status": "OK",
- "payment_id": "12020000340229",
- "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:
path Parameters
id required | string Example: 64772d88496e98e849017aa8 Id della richiesta |
Responses
Response Schema: application/pdf
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 400
- 404
- 500
- "success": false,
- "message": "invalid id",
- "error": 234,
- "data": null