Pular para o conteúdo principal

Gestão de Carteira Digital (Wallet)

O módulo de Carteira gere o saldo digital (Closed-Loop) dos condutores.

A carteira é criada automaticamente (Lazy Creation) no momento em que o utilizador a consulta ou tenta depositar fundos pela primeira vez.

Consulta de Saldo​

Recupera o saldo atualizado e o estado da carteira do utilizador autenticado.

GET /wallet

Resposta de Sucesso (200 OK)
{
    "id": "uuid-1234-5678",
    "balance": 15050,
    "currency": "BRL",
    "status": "active",
    "lastTransactionId": "ch_987654321"
  }

Adição de Fundos (Top-up)​

Gera uma intenção de depósito na carteira. O sistema cria uma ordem isolada no Pagar.me e devolve os detalhes para pagamento (ex: QR Code PIX).

POST /wallet/add-funds

Corpo da Requisição (AddFundsDto)
{
    "amount": 5000,
    "payment_method": "pix"
  }
Resposta de Sucesso (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/..."
    }
  }

Regras de Retenção e Débito​

O débito é realizado estritamente pelo ChargeService no momento em que a sessão de carregamento reporta o consumo de energia final via OCPP.