Pular para o conteúdo principal

Perfil Financeiro do Utilizador

Esta secção contém os endpoints adaptados para gerir e recuperar as informações do condutor necessárias exclusivamente para o processamento de pagamentos, faturação e auditoria cruzada.

Auto-provisionamento (Lazy Sync)​

O microsserviço financeiro (NestJS) opera de forma semi-autónoma e descentralizada em relação ao sistema legado em Laravel.

Quando um utilizador interage com o módulo financeiro pela primeira vez, a API valida o token JWT junto do sistema central e executa um Registo Sincronizado Automático (registerUserLocally). Isto garante que a base de dados de pagamentos (PostgreSQL) mantém uma cópia atualizada do cliente de forma preguiçosa (Lazy), sem necessitar de rotinas pesadas de migração de dados em massa.

Obter Perfil Financeiro Atual​

Recupera os dados financeiros, a morada de faturação e os identificadores externos (ex: pagarmeId) do condutor autenticado. Esta rota é acionada pela App Móvel antes de iniciar o fluxo de recarga.

Método: GET
Rota: /users/me
Autenticação: Obrigatória (Bearer JWT)

Resposta de Sucesso (200 OK)​

A resposta inclui os dados vitais para a submissão de cobranças antifraude e a associação do cliente ao gateway de pagamentos.

{
  "id": 123,
  "althergoId": 4567,
  "pagarmeId": "cus_000000000",
  "email": "condutor@empresa.com",
  "phone": "5511999999999",
  "meta": {
    "document": "12345678900",
    "documentType": "cpf",
    "addresses": [
      {
        "zip_code": "01000-000",
        "country": "BR",
        "state": "SP",
        "city": "São Paulo",
        "line_1": "Av. Paulista 1000 São Paulo BR"
      }
    ]
  }
}