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. Impostare 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

Inizia

• Salvare le carte senza effettuare un pagamento iniziale
• Salvare i dati bancari dell’addebito diretto SEPA
• Salvare i dati bancari dell’addebito diretto BECS

Ottenere l’autorizzazione a salvare una modalità di pagamento

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.

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 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 https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d usage=on_session