Il service Bollettino consente di integrare tramite API il servizio di pagamento di qualsiasi tipologia di bollettino postale o bancario (MAV, RAV, pagoPA, bollo Auto, tipologia 123 cioè bianco, 451, 674, 896). 
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.

1) PAGA BOLLETTINO
POST /pay/{endpoint}

L'endpoint per creare il form di pagamento del bollettino è POST ws.pagasubito.it/pay/{endpoint}
Il valore "endpoint" dovrà essere popolato con la tipologia di bollettino da pagare, ad esempio RAV, MAV, etc. I valori indicati sono solo a titolo di esempio; l'elenco completo è disponibile nella documentazione tecnica.

ESEMPIO CHIAMATA

Questo è un esempio di chiamata per il pagamento del bollettino RAV:

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

Sarà necessario passare nel body della richiesta una serie di valori. I valori dipendono dalla tipologia di servizio da pagare, ad esempio per il pagamento RAV saranno email, importo e codice RAV, mentre per pagoPA oltre all'email sarà necessario anche il numero ente PA e dell'avviso PA.
Per verificare i campi necessari per ogni tipologia di servizio rimandiamo alla documentazione tecnica.

{
  data{
    "email": "[email protected]",
    "importo": 123.12,
    "codice_rav": "12121212121212120",
    "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 sarà 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
}

Il completamento del pagamento verrà effettuato tramite Carta di Credito direttamente dal form ed è pari a 3€. 

2) RECUPERARE ELENCO PAGAMENTI
GET /pay/

È possibile ottenere la lista di tutte le richieste effettuate tramite l'endpoint GET ws.pagasubito.it/pay/

ESEMPIO CHIAMATA

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

ESEMPIO RISPOSTA

La risposta sarà 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
}

3) RECUPERARE PAGAMENTO SPECIFICO CON DETTAGLI
GET /pay/{id}

È possibile ottenere le informazioni su una singola richiesta effettuata tramite l'endpoint GET ws.pagasubito.it/pay/{id} dove il valore ID è il valore identificativo della richiesta ed è disponibile nella risposta dopo la richiesta di pagamento (POST /pay/{endpoint}) o recuperabile dalla risposta tramite endpoint GET /pay/

ESEMPIO CHIAMATA

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

ESEMPIO RISPOSTA

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
}

4) RECUPERARE RICEVUTA PAGAMENTO
GET /pay/{id}/RICEVUTA

È possibile ottenere la ricevuta di un pagamento tramite endpoint GET /pay/{id}/ricevuta dove come abbiamo visto anche precedentemente il valore ID è il valore identificativo della richiesta ed è disponibile nella risposta dopo la richiesta di pagamento (POST /pay/{endpoint}) o recuperabile dalla risposta tramite endpoint GET /pay/

ESEMPIO CHIAMATA

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

ESEMPIO RISPOSTA

La risposta sarà un pdf con le seguenti informazioni:

• Data e ora esecuzione bonifico
• CCP beneficiario
• Nominativo beneficiario
• Eseguito da
• Causale
• Codice Bollettino
• ID Operazione
• CRO Operazione
• Data di Pagamento Assolto
• Riepilogo Importi Pagamento

Il service è stato ad esempio integrato su portali servizi, uffici postali privati e GDO per il pagamento alle casse.