Passa al contenuto
Crea account o Accedi
Il logo della documentazione Stripe
/
Crea un accountAccedi
PanoramicaEseguire l'upgrade dell'integrazione
Pagamenti online
PanoramicaTrovare il caso d'uso più adattoUsa Managed Payments
Pagamenti di persona
Metodi di pagamento
Scenari di pagamento
Oltre i pagamenti

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 può presentare automaticamente i metodi di pagamento pertinenti ai tuoi clienti valutando la valuta, le limitazioni relative ai metodi di pagamento e altri parametri.

  • Segui la guida Accettare un pagamento per creare un’integrazione di checkout che utilizzi metodi di pagamento dinamici.
  • Se non desideri utilizzare metodi di pagamento dinamici, segui i passaggi riportati di seguito per configurare manualmente i metodi di pagamento nell’integrazione Checkout.

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.

Questa guida ti guida nell’abilitazione di Afterpay e mostra le differenze tra accettare pagamenti con metodi di pagamento dinamici e la configurazione manuale dei metodi di pagamento.

Abilitare Afterpay come modalità di pagamento

Quando crei una nuova sessione di Checkout, devi:

  1. Aggiungere afterpay_clearpay all’elenco payment_method_types.
  2. Assicurati che tutti i tuoi line_items siano espresse nella tua valuta nazionale e che l’importo totale non superi i limiti di transazione di Afterpay.
  3. Facoltativamente, specificare quali Paesi Checkout consente come destinazioni di spedizione tramite shipping_address_collection[allowed_countries].
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=afterpay_clearpay \
  -d "shipping_address_collection[allowed_countries][0]"=AU \
  -d "shipping_address_collection[allowed_countries][1]"=CA \
  -d "shipping_address_collection[allowed_countries][2]"=GB \
  -d "shipping_address_collection[allowed_countries][3]"=NZ \
  -d "shipping_address_collection[allowed_countries][4]"=US \
  --data-urlencode success_url="https://example.com/success"

Se non desideri la riscossione degli indirizzi di spedizione con Checkout, puoi anche fornire l’indirizzo di spedizione utilizzando payment_intent_data[shipping]. Ciò contribuisce ad aumentare i tassi di accettazione dei prestiti.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_intent_data[shipping][name]"="Jenny Rosen" \
  -d "payment_intent_data[shipping][address][line1]"="1234 Main Street" \
  -d "payment_intent_data[shipping][address][city]"="San Francisco" \
  -d "payment_intent_data[shipping][address][state]"=CA \
  -d "payment_intent_data[shipping][address][country]"=US \
  -d "payment_intent_data[shipping][address][postal_code]"=94111 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=afterpay_clearpay \
  --data-urlencode success_url="https://example.com/success"

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 eventoDescrizionePassaggi successivi
checkout.session.completedIl cliente ha autorizzato il pagamento inviando il modulo di Checkout.Attendi che il pagamento vada a buon fine o meno.
payment_intent.succeededIl 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_failedIl pagamento del cliente è stato rifiutato o non è andato a buon fine per altri motivi. Il PaymentIntent torna in stato requires_payment_method.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_action 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_action a requires_payment_method.

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

Per un PaymentIntent Afterpay con stato requires_action, 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_payment_method

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 erroreAzione consigliata
payment_intent_payment_attempt_failedErrore 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_method_provider_declineAfterpay ha rifiutato il pagamento del cliente. Successivamente, il cliente dovrà contattare Afterpay per richiedere ulteriori informazioni.
payment_intent_payment_attempt_expiredIl cliente non ha mai completato il pagamento sulla pagina di completamento della transazione di Afterpay e la sessione di pagamento è scaduta. Tre ore dopo la creazione iniziale del completamento della transazione, Stripe fa scadere automaticamente i PaymentIntents che non vengono autorizzati con successo.
payment_method_not_availableAfterpay ha riscontrato un errore relativo al servizio e non è in grado di completare la richiesta. Riprova più tardi.
amount_too_smallInserisci un importo compreso nei limiti di transazione predefiniti di Afterpay per il Paese.
amount_too_largeInserisci un importo compreso nei limiti di transazione predefiniti di Afterpay per il Paese.

Vedi anche