Bollettino PagoPA

Il service Bollettini consente di integrare tramite API il servizio di pagamento dei principali tipologie di bollettini di pagamento:

Bollettino PagoPA

PagoPA è un metodo di pagamento per effettuare tutti i versamenti alla pubblica amministrazione, centrali e locali, comprese le scuole, le università, le ASL, INPS, Agenzia delle Entrate, ma anche aziende a partecipazione pubblica e i gestori di pubblici servizi.

La modalità PagoPA è utilizzata ad esempio per il pagamento di:

Il service è composto da 3 endpoint che consentono di pagare il bollettino, recuperare la lista delle richieste effettuate, ottenere i dettagli di una richiesta di pagamento specifica.

Paga Bollettino

Il service in fase di richiesta consente di generare il form di pagamento del bollettino con l'endpoint POST/pay/{endpoint}. Il valore "endpoint" dovrà essere popolato con la tipologia di bollettino da pagare, nel nostro caso sarà PagoPA.

ESEMPIO RICHIESTA

Il valore "endpoint" dovrà essere popolato con la tipologia di bollettino da pagare, nel nostro caso sarà PagoPA.

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

Sarà necessario passare nel body della richiesta una serie di valori. Questi valori dipendono dalla tipologia di bollettino da pagare, per il pagamento del PagoPA saranno:

Questo è un esempio di payload per una richiesta di pagamento del bollettino PagoPA:

{
  data{
    "email": "[email protected]",
    "ente_pa": 122432,
    "avviso_pa": "1234567891",
    "callback": {
      "url": "https://your_domain.it/your_callback.php",
      "method": "POST",
      "field": "data",
      "headers": {
        "session_id": "oiwejdf89453urf945jfg"
      }
    }
  }

Ricordiamo che in fase di richiesta è possibile impostare anche una callback per ottenere una risposta quando il report con lo stato di pagamento definitivo sarà disponibile.

ESEMPIO RISPOSTA

La risposta conterrà l'id di richiesta ed il link al form per completare la richiesta.

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

Recupero Ricevuta Pagamento

ESEMPIO RICHIESTA

GET/pay/{id}/ricevuta

È possibile ottenere la ricevuta di un pagamento tramite endpoint GET/pay/{id}/ricevuta, a partire dall'ID, ovvero il codice identificativo della richiesta, disponibile nella risposta dopo la richiesta di pagamento (POST /pay/{endpoint}), o recuperabile dalla risposta tramite endpoint GET/pay.

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

Nella risposta sarà presente un pdf con le seguenti informazioni:

Accesso ad elenco pagamenti

ESEMPIO RICHIESTA

GET/pay

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

ESEMPIO RISPOSTA

GET/pay

La risposta conterrà l'elenco dei bollettini effettuati con l'id richiesta, il tipo di pagamento, importo e timestamp (data della richiesta).

{
  "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
}

Recupero pagamento specifico con dettagli

ESEMPIO RICHIESTA

GET/pay/{id}

È possibile inoltre ottenere le informazioni su una singola richiesta effettuata tramite l'endpoint GET /pay/{id}, a partire dall'ID.

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

ESEMPIO RISPOSTA

GET/pay/{id}

La risposta conterrà informazioni inserite in fase pagamento e dettagli sullo stato del pagamento.

{
  "data": [
    {
      "_id": "6481f66cf2129e73020e2e5d",
      "email": "[email protected]",
      "cognome": "",
     "nome":  "",
      "telefono": "",
      "ente_pa": "134553",
      "avviso_pa": "2489567",
     "type":  "pagopa",
     "timestamp":  "1686238526070",
      "owner": "[email protected]",
      "report": {
        "payment_status": "OK",
        "payment_id": "12020000340229",
        "email": "[email protected]",
       "payment_date":  "2020-04-06 17:23:10",
       "total_amount":  "123.12",

       "ente_pa":  "134553",
        "avviso_pa": "2489567"
      }
    }
  ],
  "success": true,
  "message": "",
 "error":  null
}

Il servizio consente di offrire ai propri clienti una modalità facile e veloce di pagamento dei principali bollettini ed è stato integrato ad esempio su portali servizi, uffici postali privati e GDO per il pagamento alle casse.