Passa al contenuto principale

Access the Stripe customer portal to manage subscription

POST 
/truckers/payment/register_stripe

Scopo​

Genera una sessione del portale clienti di Stripe in cui l'azienda può gestire il proprio abbonamento, cambiare piano, aggiornare la carta o visualizzare le fatture.

Obiettivo​

Fornire accesso al portale self-service di Stripe con validazione che l'account sia attivo e non scaduto.

Casi d'Uso​

  • Cambiare dal piano Basic a Professional o viceversa
  • Annullare un abbonamento attivo
  • Aggiornare il metodo di pagamento dell'abbonamento
  • Visualizzare lo storico delle fatture di Stripe
  • Scaricare fatture in PDF

Flusso di Validazione​

flowchart TD
  A[Ricevi Richiesta - returnUrl] --> B{returnUrl fornito?}
  B -->|No| C[400 MISSING_RETURN_URL]
  B -->|Sì| D{Utente autenticato?}
  D -->|No| E[404 USER_NOT_FOUND]
  D -->|Sì| F{Azienda trovata?}
  F -->|No| G[401 CIA_NOT_FOUND]
  F -->|Sì| H{UserActivity esiste?}
  H -->|No| I[404 USER_NOT_FOUND]
  H -->|Sì| J{Account non scaduto?}
  J -->|Scaduto| K[404 USER_EXPIRED]
  J -->|Attivo| L[Crea sessione Portale Clienti]
  L --> M[200 URL Portale]

Note​

  • Richiede autenticazione JWT (bearerAuth)
  • A differenza del modulo truckers, verifica che l'account non sia scaduto
  • Verifica userActivity.dateEnd > now prima di creare la sessione
  • L'URL di ritorno (returnUrl) è obbligatoria nel body
  • La sessione del portale scade in ~5 minuti (comportamento di Stripe)
  • Richiede stripe_customer configurato per l'azienda

Request​

Responses​

URL del portale clienti di Stripe

Response Headers