# 1. Flux de paiement en ligne (via QR Code)

Ce flux est destiné aux utilisateurs non authentifiés qui paient pour une session de recharge unique via une carte de crédit.

### Étapes du flux

1.  **Initiation** : L'utilisateur scanne un QR code sur une borne de recharge, ce qui le redirige vers une page web dédiée à cette borne.

2.  **Création d'une intention de paiement** :
    *   Le frontend appelle l'API pour créer une intention de paiement : `GET /api/payments/evse/:slug/with-capture`.
    *   Le backend crée une intention de paiement (Payment Intent) auprès de Stripe avec la méthode de capture manuelle (`capture_method: 'manual'`). Cela autorise un montant pré-défini sans le débiter immédiatement.
    *   Un enregistrement est créé dans la table `payments` avec le statut `PAYMENT_CREATED` et un `tagId` temporaire est généré.
    *   L'API retourne un `client_secret` au frontend.

3.  **Confirmation du paiement par l'utilisateur** :
    *   Le frontend utilise le `client_secret` pour afficher le formulaire de paiement Stripe.
    *   L'utilisateur saisit ses informations de carte bancaire et valide le paiement.

4.  **Démarrage de la transaction** :
    *   Une fois le paiement confirmé côté client, le frontend appelle l'API : `POST /api/payments/remote-start-after-payment-confirmed`.
    *   Le backend vérifie la validité du paiement, met à jour le statut de l'enregistrement `payments` à `PAYMENT_CONFIRMED`.
    *   Le backend envoie une commande `RemoteStartTransaction` à la borne via le protocole OCPP, en utilisant le `tagId` temporaire.
5.  **Session de recharge** : La session de recharge est active. Un enregistrement est créé dans la table `transactions` et lié à l'enregistrement `payments`.

6.  **Arrêt de la transaction** :
    *   L'utilisateur arrête la recharge depuis la page web, ce qui déclenche un appel à `POST /api/payments/transaction/:idOrSlug/stop`.
    *   La borne envoie une notification `StopTransaction` au backend.

7.  **Capture du paiement** :
    *   La notification `StopTransaction` déclenche un événement `transaction-payment-capture`.
    *   Un service écoute cet événement et appelle la méthode `paymentsService.capturePaymentWithCapture()`.
    *   Cette méthode finalise la transaction Stripe en capturant le montant final de la recharge (le coût réel de l'énergie consommée).
    *   Le statut de l'enregistrement `payments` est mis à jour à `PAYMENT_CAPTURED`.