Le nostre tariffe
Listino prezzi a chiamata
- Bollettini Online € 3,00 + iva
Integra il sistema di pagamento bollettini tramite API
Il service Bollettini consente di pagare qualsiasi bollettino postale o bancario in tempo reale
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.
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.
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.
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€.
È possibile ottenere la lista di tutte le richieste effettuate tramite l'endpoint GET ws.pagasubito.it/pay/
POST https://ws.pagasubito.it/pay/
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
}
È 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/
GET https://ws.pagasubito.it/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
}
È 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/
GET https://ws.pagasubito.it/pay/{id}/ricevuta
La risposta sarà un pdf con le seguenti informazioni:
Il service è stato ad esempio integrato su portali servizi, uffici postali privati e GDO per il pagamento alle casse.