# API Setup Intents

Ulteriori informazioni sull'API Setup Intents per il salvataggio delle modalità di pagamento

Puoi utilizzare l’'*API Setup Intents* (The Setup Intents API lets you build dynamic flows for collecting payment method details for future payments. It tracks the lifecycle of a payment setup flow and can trigger additional authentication steps if required by law or by the payment method) per impostare un metodo di pagamento in vista di pagamenti futuri. Funziona come un pagamento, ma non viene creato alcun addebito. [Impostare un metodo di pagamento in vista di pagamenti futuri](https://docs.stripe.com/payments/save-and-reuse.md).

L’obiettivo è salvare e ottimizzare le credenziali di pagamento per i pagamenti futuri, il che significa che la modalità di pagamento è configurata correttamente per ogni scenario. Quando configuri una carta, ad esempio, potrebbe essere necessario autenticare il cliente o controllare la validità della carta presso la sua banca. Stripe aggiorna l’oggetto `SetupIntent` nel corso di tale procedura.

## Salvare e riutilizzare le modalità di pagamento

L’API Setup Intents è utile per le aziende che aggiungono i clienti ma non addebitano loro immediatamente dei costi:

- Un’azienda di autonoleggio che raccoglie i dettagli della modalità di pagamento prima che il cliente noleggi l’auto ed effettua l’addebito sulla carta del cliente alla fine del periodo di noleggio
- Un sito web di crowdfunding che acquisisce i dati delle carte su cui effettuare gli addebiti in seguito solo se la campagna raggiunge un determinato importo
- Un’azienda di servizi pubblici che addebita un importo diverso ogni mese in base al consumo, ma raccoglie i dettagli dei pagamenti SEPA prima del pagamento del primo mese

> Puoi anche configurare metodi di pagamento per l’uso futuro quando effettui addebiti durante il [checkout](https://docs.stripe.com/payments/save-and-reuse.md?platform=checkout).

#### Inizia

- [Salvare le carte senza effettuare un pagamento iniziale](https://docs.stripe.com/payments/save-and-reuse.md)
- [Salvare i dati bancari dell’addebito diretto SEPA](https://docs.stripe.com/payments/sepa-debit/set-up-payment.md)
- [Salvare i dati bancari dell’addebito diretto BECS](https://docs.stripe.com/payments/au-becs-debit/set-up-payment.md)

## Ottenere l’autorizzazione per salvare un metodo di pagamento

Quando salvi i dati di pagamento di un cliente, sei responsabile del rispetto di tutte le leggi, i regolamenti e le regole del circuito applicabili.

### Utilizzo futuro all’interno della sessione

Se imposti un metodo di pagamento per futuri pagamenti *all’interno della sessione* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method), ad esempio visualizzando il metodo di pagamento su una pagina di checkout futura, devi ottenere esplicitamente il consenso del cliente per questo specifico utilizzo. Ad esempio, includi una casella di controllo “Salva il mio metodo di pagamento per un utilizzo futuro” per ottenere il consenso.

Se devi distinguere tra metodi di pagamento salvati solo per utilizzi offline e metodi di pagamento che è possibile presentare al cliente per futuri acquisti *all’interno della sessione* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method), puoi utilizzare il parametro [allow_redisplay](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-allow_redisplay) sull’oggetto PaymentMethod.

### Utilizzo futuro off-session

Per configurare una modalità di pagamento in vista di futuri pagamenti *all’esterno della sessione* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information) è necessaria l’autorizzazione. Creando preventivamente un contratto (talvolta noto come *mandato*), puoi effettuare gli addebiti al cliente quando non utilizza attivamente il tuo sito web o la tua app.

Aggiungi al sito web o all’app dei termini indicanti in che modo prevedi di elaborare i pagamenti e invita i clienti ad aderire. I termini devono includere almeno i seguenti elementi:

- L’autorizzazione del cliente a disporre un pagamento o una serie di pagamenti per suo conto
- La frequenza prevista per i pagamenti (una tantum o ricorrenti)
- La modalità di determinazione dell’importo del pagamento

Consulta qui il testo consigliato del mandato per il [salvataggio delle carte](https://docs.stripe.com/payments/save-and-reuse.md?platform=web&ui=elements#collect-payment-details) o il [salvataggio delle informazioni bancarie SEPA](https://docs.stripe.com/payments/sepa-debit/set-up-payment.md).

Per gli utenti interessati dalla *SCA* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase), questo accordo fa sì che i pagamenti vadano a buon fine senza interruzioni. Quando configuri l’integrazione per salvare correttamente una carta, Stripe contrassegna qualsiasi pagamento successivo all’esterno della sessione come *transazione avviata dall’esercente* (A payment made off-session with a properly authenticated saved card, can qualify as merchant-initiated transaction and be exempt from SCA) (MIT) in modo che i clienti non debbano ricollegarsi e autenticarsi. Le transazioni avviate dall’esercente richiedono un accordo tra te e il tuo cliente.

## Specifica l’utilizzo per aumentare il tasso di successo

Il parametro [usage](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-usage) indica a Stripe in che modo prevedi di utilizzare i dettagli del metodo di pagamento in futuro. Per alcuni metodi di pagamento Stripe può basarsi sulla tua impostazione di `usage` per scegliere il flusso più lineare per il cliente. L’obiettivo di questa ottimizzazione è aumentare il numero di pagamenti riusciti.

Ad esempio, le carte di credito e di debito soggette alla normativa europea *SCA* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase) possono richiedere al cliente di effettuare l’autenticazione della carta durante la procedura di salvataggio. Se imposti `usage` su `off_session`, una carta di credito o di debito viene correttamente autenticata per i pagamenti all’esterno della sessione, evitando così al cliente di doversi ricollegare ed eseguire una nuova autenticazione. Pertanto, sebbene rallenti inizialmente il flusso di configurazione, l’impostazione di `usage` su `off_session` può ridurre la necessità di intervento da parte del cliente nei successivi pagamenti all’esterno della sessione.

Tuttavia, se prevedi di utilizzare la carta solo quando il cliente completa la transazione, imposta `usage` su `on_session`. In questo modo la banca sa che prevedi di utilizzare la carta solo quando il cliente è pronto per l’autenticazione. Puoi quindi posticipare l’autenticazione dei dati della carta fino a quel momento ed evitare problemi a monte.

| Utilizzo previsto della carta                                                                                                                                                                    | valore enum usage da utilizzare          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------- |
| Solo pagamenti *all’interno della sessione* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method) | `on_session`                             |
| Solo pagamenti *all’esterno della sessione* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information)  | `off_session` (impostazione predefinita) |
| Pagamenti sia all’interno sia all’esterno della sessione                                                                                                                                         | `off_session` (impostazione predefinita) |

`Usage` è un’ottimizzazione. Una carta configurata per i pagamenti all’interno della sessione può essere comunque utilizzata per effettuare i pagamenti all’esterno della sessione, ma è più probabile che la banca rifiuti il pagamento all’esterno della sessione e richieda l’autenticazione al cliente. In entrambi i casi potrebbe essere necessaria un’autenticazione successiva, quindi [crea una procedura di recupero](https://docs.stripe.com/billing/revenue-recovery.md) nell’app. Se un pagamento con carta all’esterno della sessione richiede l’autenticazione, riporta il cliente online per completare il pagamento.

Se non viene specificato altro, `usage` è impostato automaticamente su `off_session`. Scopri come creare un SetupIntent sul tuo server e specificare il valore di `usage`:

```curl
curl https://api.stripe.com/v1/setup_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d usage=on_session
```

> Segui le istruzioni in questa pagina per assicurarti che la tua integrazione gestisca le carte che richiedono l’*autenticazione SCA* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase). Contrassegnare correttamente le transazioni consente a Stripe di richiedere le esenzioni SCA corrette per tuo conto per ridurre al minimo la necessità di autenticazione con ogni pagamento.