Passa al contenuto principale

Set up new payment method

POST 
/company/payment/setup_payment_method

Genera un URL del portale di Stripe affinché l'azienda possa aggiungere un nuovo metodo di pagamento (carta di credito/debito) in modo sicuro.

Obiettivo​

Reindirizzare l'utente al portale di Stripe dove può registrare le sue informazioni della carta senza esporre dati sensibili al backend.

Casi d'Uso​

  • Aggiungere la prima carta di credito/debito
  • Aggiungere metodi di pagamento aggiuntivi (max. 10)
  • Sostituire carte scadute con nuove

Flusso di Validazione​

flowchart TD
  A[Ricevi Richiesta - returnUrl] --> B{returnUrl fornita?}
  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{stripe_customer esiste?}
  H -->|No| I[404 STRIPE_CUSTOMER_NOT_FOUND]
  H -->|Sì| J{Conteggio < 10?}
  J -->|No| K[200 - Stringa vuota]
  J -->|Sì| L[Crea portale metodi di pagamento]
  L --> M[200 - URL del portale]

Note​

  • Richiede autenticazione JWT (bearerAuth)
  • Limite di 10 metodi di pagamento per azienda; se raggiunto restituisce `` (stringa vuota)
  • Richiede che l'azienda abbia stripe_customer (usare /register_stripe prima)
  • La returnUrl è dove Stripe reindirizza l'utente dopo aver aggiunto il metodo

Request​

Responses​

URL del portale o stringa vuota se è stato raggiunto il limite di 10

Response Headers