> ## Documentation Index
> Fetch the complete documentation index at: https://docs.serenest.terros.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Rechargement de badge - technique

> Documentation technique du rechargement de badge via PiPay

## Mise à jour automatique de l'email

L'email est automatiquement mis à jour dans PiPay lors de la connexion de l'utilisateur ou au démarrage de la session.

## Endpoint `envoi_epaiement_compte`

L'endpoint `envoi_epaiement_compte` est utilisé pour créditer ou débiter de l'argent d'un badge.

Il a également une seconde utilisation cachée de la documentation Pi Electronique : lorsque le montant est `0`, l'endpoint peut être utilisé pour **inscrire un utilisateur au service PiPay**.

<Card title="Documentation fonctionnelle" icon="book" href="https://gitlab.com/terros1/serenest/ias-bo-client/-/wikis/pi/api/endpoint/envoi_epaiement_compte#notes">
  Lien vers le wiki GitLab
</Card>

## Fonctionnement

Cet endpoint prend les paramètres suivants :

* L'identification de l'utilisateur et du serveur
* Le montant à créditer/débiter

| Montant        | Action                                        |
| -------------- | --------------------------------------------- |
| `montant > 0`  | Crédit du badge                               |
| `montant < 0`  | Débit du badge                                |
| `montant == 0` | Inscription de l'utilisateur au service PiPay |

<Warning>
  Lorsque le `montant == 0`, le champ `date_fin_validite` n'est pas retourné dans la réponse.
</Warning>

## Inscription automatique PiPay

Une inscription automatique a été ajoutée : si l'utilisateur n'est pas encore inscrit au service PiPay, l'inscription se fait automatiquement lors de la première connexion.

* **Merge requests** : [!283 (merged)](https://gitlab.com/terros1/serenest/ias-bo-client/-/merge_requests/283) | [!285 (merged)](https://gitlab.com/terros1/serenest/ias-bo-client/-/merge_requests/285)