Passa al contenuto principale

Register company as Stripe customer

POST 
/company/payment/register_stripe

Crea un cliente in Stripe per l'utente autenticato se non ne ha ancora uno registrato, e restituisce l'ID del cliente.

Obiettivo​

Inizializzare la relazione tra l'utente dell'azienda e Stripe, ottenendo l'ID stripe_customer necessario per tutte le operazioni di pagamento successive.

Casi d'Uso​

  • Primo registro prima di configurare i metodi di pagamento
  • Verificare se l'utente è già registrato in Stripe
  • Prerequisito per sottoscrizioni e pagamenti

Flusso di Validazione​

flowchart TD
  A[Ricevi Richiesta] --> B{Utente autenticato?}
  B -->|No| C[404 USER_NOT_FOUND]
  B -->|Sì| D{Utente nel DB?}
  D -->|No| E[401 USER_NOT_FOUND]
  D -->|Sì| F{stripe_customer esiste?}
  F -->|Sì| G[Restituisci ID esistente]
  F -->|No| H[Crea cliente Stripe]
  H --> I{Creazione OK?}
  I -->|No| J[401 STRIPE_ACCOUNT_NOT_CREATED]
  I -->|Sì| K[Salva ID in user.payment_settings]
  K --> L[200 successo + stripe_customer]
  G --> L

Note​

  • Richiede autenticazione JWT (bearerAuth)
  • Idempotente: se stripe_customer esiste già, restituisce l'ID esistente
  • Opera sul company_user, non direttamente sull'azienda
  • Nessun body richiesto

Request​

Responses​

Cliente Stripe registrato con successo o già esistente.

Response Headers