Aller au contenu principal

Gestion du Portefeuille Numérique (Wallet)

Le module Portefeuille gère le solde numérique (Closed-Loop) des conducteurs. Le portefeuille est créé automatiquement (Lazy Creation) au moment où l'utilisateur le consulte ou tente de déposer des fonds pour la première fois.

Consultation du Solde​

Récupère le solde mis à jour et l'état du portefeuille de l'utilisateur authentifié.

GET /wallet

Réponse de Succès (200 OK)
{
  "id": "uuid-1234-5678",
  "balance": 15050,
  "currency": "BRL",
  "status": "active",
  "lastTransactionId": "ch_987654321"
}

Ajout de Fonds (Top-up)​

Génère une intention de dépôt dans le portefeuille. Le système crée une commande isolée dans Pagar.me et renvoie les détails de paiement (ex : QR Code PIX).

POST /wallet/add-funds

Corps de la Requête (AddFundsDto)
{
  "amount": 5000,
  "payment_method": "pix"
}
Réponse de Succès (201 Created)
{
  "id": 102,
  "status": "pending",
  "amount": 5000,
  "pagarmeChargeId": "ch_123456",
  "paymentDetails": {
    "pixQrCode": "00020101021243650014br.gov.bcb.pix...",
    "pixQrCodeUrl": "https://api.pagar.me/core/v5/transactions/qr_code/..."
  }
}

Règles de Rétention et de Débit​

Le débit est strictement effectué par le ChargeService au moment où la session de charge signale la consommation d'énergie finale via OCPP.