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

Conseils utiles pour commencer Bulletin de versement

Obtenir le Token dans la section appropriée avant de commencer.

Utilisez l'outil en ligne ou générez-le via l'API. Définissez la date d'expiration, un nom utile et ajoutez maintenant un ensemble d'étendues pour limiter les actions possibles que votre jeton peut effectuer.

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

Service web qui vous permet de payer vos factures, mav, rav, pago pa et la taxe sur les véhicules.

C'est la première fois que vous venez ici ? Générer un nouveau jeton d'accès

Pay

Méthodes de traitement des paiements

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:

bearerAuth

path Parameters

endpoint

required

any

Enum: 123 451 674 896 "rav" "mav" "pagopa" "bolloauto"

Type de service demandé

Request Body schema: application/json

One of

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

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

}

Toutes les demandes

Méthode qui vous permet de voir toutes vos demandes de paiement.

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

}

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:

bearerAuth

path Parameters

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

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

}

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:

bearerAuth

path Parameters

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

}

Web Service Revision: 2.0.0