Paiement des bulletin de versement italien via API et en temps réel
Service de paiement disponible pour tout type de bulletin de versement italien
Toutes les connaissances dont vous avez besoin
Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.
Obtenir le Token dans la section appropriée avant de commencer.
- Oas file url https://console.openapi.com/oas/fr/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
- GET test.ws.pagasubito.it/pay
- POST test.ws.pagasubito.it/pay
Bollettini (1.0.0)
Service web qui vous permet de payer vos factures, mav, rav, pago pa et la taxe sur les véhicules.
Demande de paiement de facture
Méthode permettant de demander un paiement. Le résultat sera une url qui vous redirigera vers le portail de paiement.
Authorizations:
path Parameters
endpoint required | any Enum: 123 451 674 896 "rav" "mav" "pagopa" "bolloauto" Type de service demandé |
Request Body schema: application/json
email required | string <email> courriel du client |
cognome | string nom de famille du client |
nome | string prénom du client |
indirizzo | string adresse du client |
telefono | string téléphone client |
importo required | number <= 2496.99 montant à payer |
cap | string <= 5 characters code postal du client |
localita | string ville cliente |
provincia | string <= 2 characters province du client |
ccp required | string <= 12 characters compte postal |
causale required | string causal |
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
Toutes les demandes
Méthode qui vous permet de voir toutes vos demandes de paiement.
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
Demande unique
Méthode qui vous permet de voir la demande unique identifiée par l'identifiant. Le champ "rapport" n'est saisi qu'après la finalisation du paiement et contient des données sur le résultat du paiement.
Authorizations:
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
- 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
Obtenir le reçu
Méthode permettant de télécharger le reçu identifié par l'ID. Si le reçu existe, un fichier pdf est renvoyé.
Authorizations:
path Parameters
id required | string Example: 64772d88496e98e849017aa8 Request id |
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