Bollettino 896

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

Bollettino 896

Il bollettino 896 è una tipologia di bollettino premarcato, cioè un bollettino in cui le informazioni per completare il pagamento sono già disponibili e - in caso di versione cartacea - prestampate all'interno del modello.
È la tipologia di bollettino per il pagamento di importi fissi definiti direttamente dal creditore.

Il bollettino 896 è tra quelli più utilizzati 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}.

ESEMPIO RICHIESTA

POST/pay/{endpoint}

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

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

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

Questo è un esempio di payload per il pagamento del bollettino 896.

{
  data{
    "email": "[email protected]",
    "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"
      }
    }
  }

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

POST/pay/{endpoint}

La risposta conterrà l'id 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

ESEMPIO RISPOSTA

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

Accesso ad elenco pagamenti

ESEMPIO RICHIESTA

GET/pay

Tramite l'endpoint GET/paysi può ottenere la lista di tutte le richieste effettuate.

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.