API Setup Intents
Puoi utilizzare l’API Setup Intents per impostare una modalità di pagamento in vista di pagamenti futuri. Funziona come un pagamento, ma non viene creato alcun addebito. Configura una modalità di pagamento in vista di pagamenti futuri.
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
Nota
Puoi configurare modalità di pagamento per un uso futuro anche con Checkout.
Inizia
- Salvare le carte senza effettuare un pagamento iniziale
- Salvare le informazioni bancarie per i pagamenti con addebito diretto SEPA
- Salvare i dati bancari per i pagamenti con addebito diretto BECS
Ottenere l’autorizzazione a salvare una modalità di pagamento
Compliance
You’re responsible for your compliance with all applicable laws, regulations, and network rules when saving a customer’s payment details. If you set up a payment method for future on-session payments, such as displaying the payment method on a future checkout page, make sure that you explicitly collect consent from the customer for this specific use. For example, include a “Save my payment method for future use” checkbox to collect consent. If you need to differentiate between payment methods saved only for offline usages and payment methods you can present to your customer for future on-session purchases, you can utilize the allow_redisplay parameter on the PaymentMethod object.
Per configurare una modalità di pagamento in vista di futuri pagamenti all’esterno della sessione è 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 o il salvataggio delle informazioni bancarie SEPA.
Per gli utenti interessati dalla SCA, 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 (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.
Aumentare la percentuale di riuscita specificando l’utilizzo
Il parametro usage indica a Stripe in che modo prevedi di utilizzare i dettagli della modalità di pagamento in futuro. Per alcune modalità 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 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 | on_session |
Solo pagamenti all’esterno della sessione | off_session (impostazione predefinita) |
Pagamenti sia all’interno sia all’esterno della sessione | off_session (impostazione predefinita) |
Il parametro usage
è un’ottimizzazione. Una carta configurata per i pagamenti all’interno della sessione può essere comunque utilizzata per effettuare 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 un processo di recupero nell’app. Quando un pagamento con carta all’esterno della sessione richiede l’autenticazione, il cliente si deve ricollegare 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
:
Nota
Segui le istruzioni in questa pagina per assicurarti che la tua integrazione gestisca le carte che richiedono l’autenticazione SCA. 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.