Italienische Bulletin-Zahlung über API und in Echtzeit
Zahlungsservice für alle Arten von Rechnungen verfügbar
All das Wissen, das Sie benötigen
Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.
Nützliche Tipps für den Einstieg
Zahlung Rechnungen
Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.
Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.
- Oas file url https://console.openapi.com/oas/de/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)
Webservice, mit dem Sie Rechnungen, Mav, Rav, Pago Pa und Kfz-Steuer bezahlen können.
Antrag auf Zahlung einer Rechnung
Eine Methode zur Beantragung einer Zahlung. Das Ergebnis ist eine URL, die den Benutzer an das Zahlungsportal weiterleitet.
Authorizations:
bearerAuth
path Parameters
| endpoint required | any Enum: 123 451 674 896 "rav" "mav" "pagopa" "bolloauto" Art der gewünschten Dienstleistung |
Request Body schema: application/json
One of
| email required | string <email> Kunden-E-Mail |
| cognome | string Nachname des Kunden |
| nome | string Kundenname |
| indirizzo | string Kundenadresse |
| telefono | string Kundentelefon |
| importo required | number <= 2496.99 ZAHLUNG |
| cap | string <= 5 characters Postleitzahl des Kunden |
| localita | string Kundenstadt |
| provincia | string <= 2 characters Bundesland des Kunden |
| ccp required | string <= 12 characters Postkonto |
| 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
Content type
application/json
Example
{
- "importo": 123.12,
- "ccp": "12324",
- "causale": "string",
- "callback": {
- "method": "POST",
- "field": "data",
- "headers": {
- "session_id": "oiwejdf89453urf945jfg"
Response samples
- 200
- 400
- 404
- 406
- 428
Content type
application/json
{
- "data": {
- "id": "6489ca34bf95b3541e0ccb25",
- "success": true,
- "message": "",
- "error": null
Alle Anfragen
Methode, mit der alle Zahlungsaufforderungen eingesehen werden können.
Authorizations:
bearerAuth
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
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
Einzelne Anfrage
Methode, mit der die durch die ID identifizierte Einzelanforderung angezeigt werden kann. Das Feld "Bericht" wird erst nach Abschluss der Zahlung eingefügt und enthält Daten über das Ergebnis der Zahlung.
Authorizations:
bearerAuth
path Parameters
| id required | string Example: 64772d88496e98e849017aa8 Anfrage 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
Content type
application/json
Example
{
- "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
Erhalt einer Quittung
Methode zum Herunterladen der durch die ID identifizierten Quittung. Wenn die Quittung existiert, wird eine PDF-Datei zurückgegeben.
Authorizations:
bearerAuth
path Parameters
| id required | string Example: 64772d88496e98e849017aa8 Anfrage Id |
Responses
Response Schema: application/pdf
string <binary>
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
Content type
application/json
{
- "success": false,
- "message": "invalid id",
- "error": 234,
- "data": null