Bulletin 896

Der Bulletin-Dienst ermöglicht die Integration des Zahlungsdienstes für die wichtigsten Arten von Bulletins über API:

Bulletin 896

Das Merkblatt 896 ist eine Art vorgedrucktes Merkblatt, d.h. ein Merkblatt, in dem die Informationen für den Abschluss der Zahlung bereits vorhanden und im Falle einer Papierversion innerhalb der Vorlage vorgedruckt sind.

Es handelt sich dabei um die Art der Mitteilung für die Zahlung von direkt vom Gläubiger festgelegten Festbeträgen:

Der Dienst besteht aus 3 Endpoint, die es Ihnen ermöglichen, das Bulletin zu bezahlen, die Liste der gestellten Anträge abzurufen und die Details eines bestimmten Zahlungsantrags zu erhalten.

BULLETIN BEZAHLEN

POST /pay/{endpoint}

Der Dienst in der Antragsphase ermöglicht die Erstellung des Bulletin-Zahlungsformulars mit dem Endpoint POST ws.pagasubito.it/pay/{endpoint}Der Wert „Endpunkt“ muss mit der Art der zu zahlenden Meldung gefüllt werden, in unserem Fall ist es die Bulletin 896.

BEISPIELANFORDERUNG

Dies ist ein Beispiel für einen Antrag auf Bezahlung des Bulletins 896:

POST  https://ws.pagasubito.it/pay/896

Sie müssen eine Reihe von Werten in den Hauptteil der Anfrage eingeben. Diese Werte hängen von der Art des zu zahlenden Bulletins ab, für die Zahlung für das Bulletin 896 sind es folgende:

Dies ist ein Beispiel für die Payload einer Zahlungsanforderung für die Bulletin 896.

{
  data{
    "email": "email@prova.com",
    "importo": 123.12,
    "ccp": "121215",
    "codice_bollettino": "12121212121212120",
    "callback": {
      "url": "https://your_domain.it/your_callback.php",
      "method": "POST",
      "field": "data",
      "headers": {
        "session_id": "oiwejdf89453urf945jfg"
      }
    }
  }

Bitte beachten Sie, dass ein Callback auch während der Anfragephase gesetzt werden kann, um eine Antwort zu erhalten, wenn der Bericht mit dem endgültigen Zahlungsstatus verfügbar ist.

BEISPIELANTWORT

Die Antwort enthält die Anfrage-ID und den Link zum Formular, mit dem die Anfrage ausgefüllt werden kann.

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

Die Zahlung erfolgt per Kreditkarte direkt aus dem Formular und beträgt 3 EUR.

RÜCKFORDERUNG DES ZAHLUNGSEINGANGS

GET /pay/{id}/RICEVUTA

Es ist möglich, über den Endpoint GET /pay/{id}/ricevuta eine Zahlungsbestätigung zu erhalten wo, wie wir oben gesehen haben, der id-Wert der Identifikationswert der Anforderung ist und in der Antwort nach der Zahlungsanforderung (POST /pay/{endpoint}) zur Verfügung steht oder über den Endpoint GET /pay/ aus der Antwort abrufbar ist.

BEISPIELANFORDERUNG

GET https://ws.pagasubito.it/pay/{id}/ricevuta

BEISPIELANTWORT

Die Antwort enthält eine PDF-Datei mit folgenden Informationen:

ZUGANG ZUR ZAHLUNGSLISTE

GET /pay/

Es ist möglich, eine Liste aller Anfragen zu erhalten, die über den Endpoint GET ws.pagasubito.it/pay/

BEISPIELANFORDERUNG

POST https://ws.pagasubito.it/pay/

BEISPIELANTWORT

Die Antwort enthält die Liste der GETätigten Meldungen mit der Anforderungs-ID, der Zahlungsart, dem Betrag und dem Zeitstempel (Datum der Anforderung).

{
  "data": [
    {
      "_id": "6481f66cf2129e73020e2e5d",
      "type": "pagopa",
      "importo": "0.00",
      "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
}

ABRUF SPEZIFISCHER ZAHLUNGEN MIT DETAILS

GET/pay/{id}

Es ist möglich, Informationen über eine einzelne Anfrage, die über den Endpoint GET ws.pagasubito.it/pay/{id} gestellt wurde wobei der ID-Wert die Anforderungs-ID ist und in der Antwort nach der Zahlungsanforderung ( POST /pay/{endpoint}) zur Verfügung steht oder aus der Antwort über den Endpoint abrufbar ist GET /pay/

BEISPIELANFORDERUNG

GET https://ws.pagasubito.it/pay/{id}

BEISPIELANTWORT

Die Antwort enthält die während der Zahlung eingegebenen Informationen und Angaben zum Zahlungsstatus.

{
  "data": [
    {
      "_id": "6481f66cf2129e73020e2e5d",
      "email": "email@prova.com",
      "cognome": "",
     "nome":  "",
      "telefono": "",
      "ente_pa": "134553",
      "avviso_pa": "2489567",
     "type":  "pagopa",
     "timestamp":  "1686238526070",
      "owner": "useremail@prova.com",
      "report": {
        "payment_status": "OK",
        "payment_id": "12020000340229",
        "email": "useremail@prova.com",
       "payment_date":  "2020-04-06 17:23:10",
       "total_amount":  "123.12",
       "ente_pa":  "134553",
        "avviso_pa": "2489567"
      }
    }
  ],
  "success": true,
  "message": "",
 "error":  null
}

Der Dienst bietet seinen Kunden eine schnelle und einfache Möglichkeit, die wichtigsten Rechnungen zu bezahlen und wurde z. B. in Dienstleistungsportale, private POST ämter und Einzelhandelsgeschäfte für die Bezahlung an den Kassen integriert.