Bulletin MAV

Le service Bulletin permet d'intégrer le service de paiement des principaux types de bulletins via l'API:

Bulletin MAV

MAV est un acronyme qui signifie «Paiement par avis». Le bulletin MAV est une procédure interbancaire standardisée, largement utilisée pour le règlement des dettes, et qui implique généralement le transfert d'un montant de la banque collectrice, c'est-à-dire la banque du débiteur, à la banque remboursante, c'est-à-dire la banque du créancier.

Le bulletin MAV est souvent utilisé par les organismes publics et les organisations telles que les universités pour la collecte des frais de scolarité.

Ce type de bulletin se caractérise par la présence d'un code numérique à 17 chiffres qui identifie de manière unique la transaction et qui est essentiel pour que le créancier associe correctement les paiements aux sujets. Avec l'ID, des champs tels que le nom du débiteur, le montant, le motif et la date d'échéance seront disponibles.

Le service se compose de trois endpoints qui permettent de payer le bulletin, de récupérer la liste des requêtes effectuées et d'obtenir les détails d'une demande de paiement spécifique.

PAYER LE BULLETIN

Dans la phase de demande, le service permet de générer le formulaire de paiement du bulletin à l'aide du endpoint POST /pay/{endpoint}. La valeur 'endpoint' doit être renseignée avec le type de bulletin à payer, dans notre cas il s'agit du Bulletin MAV.

EXEMPLE DE RÊQUETE

Voici un exemple de demande de paiement du Bulletin MAV:

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

Une série de valeurs doit être transmise dans le corps de la requête. Ces valeurs dépendent du type de bulletin à payer, pour le paiement du Bulletin MAV elles seront:

Voici un exemple de payload pour une demande de paiement du Bulletin MAV.

{
  data{
    "email": "email@prova.com",
    "tipo_veicolo": 2,
    "targa": "FE425LX",
    "callback": {
      "url": "https://your_domain.it/your_callback.php",
      "method": "POST",
      "field": "data",
      "headers": {
        "session_id": "oiwejdf89453urf945jfg"
      }
    }
  }

N'oubliez pas que lorsque vous faites une demande, il est également possible de mettre en place un callback afin d'obtenir une réponse lorsque le rapport sur l'état final du paiement est disponible.

EXEMPLE DE RÉPONSE

La réponse contiendra l'identifiant de la demande et le lien vers le formulaire pour compléter la requête.

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

Le paiement sera effectué par carte de crédit directement à partir du formulaire et s'élèvera à 3 euros.

RÉCUPÉRATION DU REÇU DE PAIEMENT

Il est possible d'obtenir le reçu d'un paiement via l'endpoint GET/pay/{id}/ricevuta où, comme nous l'avons vu plus haut, la valeur ID est la valeur d'identification de la demande et est disponible dans la réponse après la demande de paiement (POST/pay/{endpoint}), ou est récupérable à partir de la réponse via l'endpoint GET/pay/.

EXEMPLE DE RÊQUETE

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

EXEMPLE DE RÉPONSE

La réponse contiendra un pdf avec les informations suivantes:

ACCÈS À LA LISTE DES PAIEMENTS

Il est possible d'obtenir une liste de toutes les demandes effectuées via l'endpoint GET/pay.

EXEMPLE DE RÊQUETE

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

EXEMPLE DE RÉPONSE

La réponse contiendra la liste des bulletins émis avec l'identifiant de la demande, le type de paiement, le montant et l'horodatage (date de la demande).

{
  "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": "MAV",
     "importo":  "123.12",
     "timestamp":  "1686238470629"
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

RÉCUPÉRATION D'UN PAIEMENT SPÉCIFIQUE AVEC DÉTAILS

Il est possible de récupérer des informations sur une seule demande effectuée via l'endpoint GET /pay/{id} où la valeur ID est l'identifiant de la demande et est disponible dans la réponse après la demande de paiement (POST/pay/{endpoint}), ou est récupérable à partir de la réponse via l'endpoint GET/pay.

EXEMPLE DE RÊQUETE

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

EXEMPLE DE RÉPONSE

La réponse contiendra les informations saisies lors du paiement et les détails de l'état du paiement.

{
  "data": [
    {
      "_id": "6481f66cf2129e73020e2e5d",
      "email": "email@prova.com",
      "cognome": "",
     "nome":  "",
      "telefono": "",
      "ente_pa": "134553",
      "avviso_pa": "2489567",
     "type":  "pagopa",
     "timestamp":  "1686238526070",
      "owner": "useremail@prova.com",
      "report": {
        "payment_status": "OK",
        "payment_id": "12020000340229",
        "email": "useremail@prova.com",
       "payment_date":  "2020-04-06 17:23:10",
       "total_amount":  "123.12",
       "ente_pa":  "134553",
        "avviso_pa": "2489567"
      }
    }
  ],
  "success": true,
  "message": "",
 "error":  null
}

Le service offre à ses clients un moyen rapide et facile de payer les principales factures et a été intégré, par exemple, dans des portails de services, des bureaux de poste privés et des points de vente pour le paiement aux caisses.