Accettare un pagamento Afterpay o Clearpay
Scopri come accettare Afterpay (nota anche come Clearpay nel Regno Unito), una modalità di pagamento utilizzata in Stati Uniti, Canada, Regno Unito, Australia e Nuova Zelanda.
Attenzione
Stripe mostra automaticamente ai clienti le opzioni dei metodi di pagamento valutando la loro valuta, le limitazioni dei metodi di pagamento e altri parametri. Ti consigliamo di configurare i metodi di pagamento dalla Dashboard Stripe seguendo le istruzioni contenute in Accettare un pagamento.
Se vuoi continuare a configurare manualmente i metodi di pagamento che mostri ai clienti con Checkout, usa questa guida. In alternativa, aggiornare la tua integrazione per configurare i metodi di pagamento nella Dashboard.
Afterpay è un metodo di pagamento monouso con notifica immediata che richiede ai clienti di autenticare il pagamento. I clienti vengono reindirizzati al sito Afterpay dove possono accettare i termini di un piano di rateizzazione. Quando il cliente accetta i termini, Afterpay garantisce la disponibilità dei fondi del cliente e li trasferisce sul tuo account Stripe. Il cliente ripaga direttamente Afterpay nel tempo.
Nota
Prima di avviare l’integrazione, assicurati che il tuo account sia idoneo per Afterpay accedendo alle impostazioni dei metodi di pagamento.
Determinare la compatibilità
Per supportare i pagamenti Afterpay, una sessione di Checkout deve soddisfare tutte le seguenti condizioni:
- Puoi usare solo le voci riga una tantum (i piani di abbonamento ricorrenti non sono supportati).
- I prezzi devono essere indicati nella valuta nazionale.
Accettare un pagamento
Nota
Questa guida si basa sull’integrazione di Checkout che permette di accettare un pagamento.
Utilizza questa guida per scoprire come abilitare Afterpay. Mostra le differenze tra l’accettazione di un pagamento con carta e l’uso di Afterpay.
Abilitare Afterpay come modalità di pagamento
Quando crei una nuova sessione di Checkout, devi:
- Aggiungere
afterpay_
all’elencoclearpay payment_
.method_ types - Accertarti che tutte le
line_
utilizzino la tua valuta nazionale.items - Ti consigliamo di raccogliere gli indirizzi di spedizione aggiungendo il tuo Paese a
shipping_
. Se non desideri raccogliere gli indirizzi di spedizione con Checkout, puoi anche indicarli utilizzandoaddress_ collection[allowed_ countries] payment_
. Questo aiuta ad aumentare i tassi di accettazione dei prestiti.intent_ data[shipping]
Evadere gli ordini
Utilizza un metodo come i webhook per gestire l’evasione degli ordini, senza aspettare che il cliente torni alla pagina dello stato dei pagamenti.
Gli eventi indicati di seguito vengono inviati al variare dello stato del pagamento:
Nome evento | Descrizione | Passaggi successivi |
---|---|---|
checkout.session.completed | Il cliente ha autorizzato il pagamento inviando il modulo di Checkout. | Attendi che il pagamento vada a buon fine o meno. |
payment_intent.succeeded | Il pagamento del cliente è andato a buon fine. Lo stato del PaymentIntent passa a succeeded . | Evadi l’ordine dei prodotti o dei servizi acquistati dal cliente. |
payment_intent.payment_failed | Il pagamento del cliente è stato rifiutato o non è andato a buon fine per altri motivi. Il PaymentIntent torna in stato requires_ . | Contatta il cliente via email e chiedigli di effettuare un nuovo ordine. |
Ulteriori informazioni sull’evasione degli ordini.
Testare la tua integrazione
Quando testi la tua integrazione di Checkout, seleziona Afterpay come modalità di pagamento e fai clic sul pulsante Paga.
Testa la tua integrazione Afterpay con le tue chiavi API di test visualizzando la pagina di reindirizzamento. Puoi testare il caso di pagamento riuscito autenticando il pagamento sulla pagina di reindirizzamento. Il PaymentIntent passerà da requires_
a succeeded
.
Per testare il caso in cui l’utente non riesce a effettuare l’autenticazione, usa le tue chiavi API di test e visualizza la pagina di reindirizzamento. In questa pagina, fai clic su Interrompi pagamento di test. Il PaymentIntent passerà da requires_
a requires_
.
Per i PaymentIntent con acquisizione manuale in modalità di test, il PaymentIntent non acquisito scade automaticamente 10 minuti dopo che viene concessa l’autorizzazione.
Pagamenti non riusciti
Afterpay decide se accettare o rifiutare una transazione in base a diversi fattori, ad esempio da quanto tempo l’acquirente utilizza Afterpay, l’importo in sospeso che il cliente deve rimborsare o il valore dell’ordine corrente.
Dato che i pagamenti Afterpay hanno un tasso di rifiuto più elevato rispetto a molti metodi di pagamento, dovresti sempre includere opzioni di pagamento aggiuntive nel tuo flusso di pagamento, come ad esempio card
. In questi casi, il PaymentMethod viene scollegato e lo stato dell’oggetto PaymentIntent diventa automaticamente a requires_
.
Per un PaymentIntent Afterpay con stato requires_
, i clienti devono completare il pagamento entro tre ore dal reindirizzamento al sito Afterpay (ciò non riguarda i pagamenti rifiutati). In caso contrario, l’oggetto PaymentMethod verrà scollegato e lo stato dell’oggetto PaymentIntent passerà automaticamente a requires_
In questi casi, invita il cliente a riprovare con una diversa opzione di pagamento presente nel tuo flusso di completamento della transazione.
Codici di errore
Questi sono i codici di errore più diffusi e le corrispondenti azioni consigliate:
Codice di errore | Azione consigliata |
---|---|
payment_ | Errore generico che indica che il pagamento Afterpay non è riuscito. Può trattarsi anche di un rifiuto che non appare come un codice di errore di rifiuto. |
payment_ | Afterpay ha rifiutato il pagamento del cliente. Successivamente, il cliente dovrà contattare Afterpay per richiedere ulteriori informazioni. |
payment_ | Il cliente non ha mai completato il pagamento nella pagina di pagamento di Afterpay e la sessione di pagamento è scaduta. Stripe fa scadere automaticamente i Payment Intent non autorizzati 3 ore dopo la creazione del pagamento iniziale. |
payment_ | Afterpay ha riscontrato un errore relativo al servizio e non è in grado di completare la richiesta. Riprova più tardi. |
amount_ | Inserisci un importo compreso nei limiti di transazione predefiniti di Afterpay per il Paese. |
amount_ | Inserisci un importo compreso nei limiti di transazione predefiniti di Afterpay per il Paese. |