Bollettino MAV

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

Bollettino MAV

MAV è una sigla ed indica "Pagamento Mediante Avviso". Si tratta di una procedura interbancaria standardizzata, diffusa per il saldo di crediti, e prevede generalmente il trasferimento di un importo dalla banca esattrice, cioè quella del debitore, alla banca assuntrice, cioè del creditore.

La modalità MAV è utilizzata spesso da enti pubblici e organizzazioni come l'Università per la riscossione delle tasse di iscrizioni.

Questa tipologia di bollettino si caratterizza dalla presenza di un codice numerico di 17 cifre che identifica in maniera univoca l’operazione ed è fondamentale per il soggetto creditore per associare correttamente i pagamenti ai soggetti. Insieme all'ID saranno disponibili campi come nominativo debitore, importo, causale e data scadenza.

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.

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

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à MAV.

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

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

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

{
  data{
    "email": "[email protected]",
    "importo": 122.32,
    "codice_mav": "12345678912345678",
    "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

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.