Passa al contenuto principale

Get checkout URLs for subscription plans

GET 
/company/payment/urls

Genera URL di sessione di checkout di Stripe per ogni piano di abbonamento disponibile, pronte per reindirizzare l'utente.

Obiettivo​

Fornire al frontend i link diretti a Stripe Checkout affinché l'azienda possa selezionare e pagare un piano di abbonamento.

Casi d'Uso​

  • Mostrare card dei piani con pulsanti Abbonati
  • Reindirizzare l'utente a Stripe Checkout per completare il pagamento
  • Presentare un confronto dei piani disponibili con i relativi prezzi

Flusso di Validazione​

flowchart TD
  A[Ricevi Richiesta] --> B{Utente autenticato?}
  B -->|No| C[404 USER_NOT_FOUND]
  B -->|Sì| D{Azienda trovata?}
  D -->|No| E[401 CIA_NOT_FOUND]
  D -->|Sì| F[Recupera piani dal DB]
  F --> G[Recupera prezzi Stripe]
  G --> H[Crea sessioni Checkout per piano]
  H --> I[200 OK - Piani + URL]

Note​

  • Richiede autenticazione JWT (bearerAuth)
  • Se l'azienda ha stripe_customer, lo associa alla sessione
  • Se non ha stripe_customer, utilizza l'email da invoice_data.email
  • L'URL di ritorno è fissa: ${HOST_FRONT}/admin/config
  • Modalità abbonamento: subscription (non pagamento una tantum)
  • Include client_reference_id con il riferimento dell'azienda

Request​

Responses​

Elenco dei piani con URL di checkout di Stripe

Response Headers