Passa al contenuto principale

Set default payment method

POST 
/company/payment/default_payment_method/:id

Designa un metodo di pagamento esistente come predefinito per tutte le operazioni di pagamento future dell'azienda.

Obiettivo​

Aggiornare payment_settings.default_payment_method nell'azienda affinché i pagamenti delle consegne vengano elaborati con quella carta.

Casi d'uso​

  • Selezionare la carta principale dopo averne aggiunta una nuova
  • Cambiare il metodo predefinito dopo il rinnovo di una carta
  • Designare un metodo attivo prima di elaborare una consegna

Flusso di validazione​

flowchart TD
  A[Ricevi Richiesta - id] --> 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{stripe_customer esiste?}
  F -->|No| G[404 STRIPE_CUSTOMER_NOT_FOUND]
  F -->|Sì| H{Il PM appartiene al cliente?}
  H -->|No| I[401 PAYMENT_METHOD_NOT_FOUND]
  H -->|Sì| J[Imposta come default_payment_method]
  J --> K[Salva azienda]
  K --> L[200 success: true]

Note​

  • Richiede autenticazione JWT (bearerAuth)
  • Solo un metodo può essere predefinito alla volta
  • La validazione di proprietà verifica che il PM appartenga allo stripe_customer dell'azienda
  • Il cambio è immediato e si applica ai prossimi pagamenti di consegna

Request​

Responses​

Metodo di pagamento impostato come predefinito

Response Headers