Passa al contenuto
Crea account
o
Accedi
Il logo della documentazione Stripe
/
Chiedi all'IA
Crea un account
Accedi
Inizia
Pagamenti
Automazione finanziaria
Per piattaforme e marketplace
Gestione del denaro
Strumenti di sviluppo
Inizia
Pagamenti
Automazione finanziaria
Inizia
Pagamenti
Automazione finanziaria
Per piattaforme e marketplace
Gestione del denaro
Panoramica
Informazioni sui pagamenti con Stripe
Eseguire l'upgrade dell'integrazione
Analisi dei dati sui pagamenti
Pagamenti online
PanoramicaTrovare il caso d'uso più adattoManaged Payments
Utilizzare Payment Links
Creare una pagina di pagamento
Creare un'integrazione iniziale
Creare un'integrazione in-app
Modalità di pagamento
Aggiungere modalità di pagamento
    Panoramica
    Opzioni di integrazione delle modalità di pagamento
    Gestire i metodi di pagamento predefiniti nella Dashboard
    Tipi di modalità di pagamento
    Carte
    Pagare con il saldo Stripe
    Addebiti bancari
    Reindirizzamenti bancari
    Trasferimenti bancari
    Bonifici (Sources)
    Acquista ora, paga dopo
      Affirm
      Afterpay / Clearpay
        Accettare un pagamento
        Messaggi sul sito
      Alma
      Billie
      Capchase Pay
      Klarna
      Kriya
      Mondu
      Pagamento su fattura
      Scalapay
      SeQura
      Sunbit
      Zip
    Pagamenti in tempo reale
    Voucher
    Wallet
    Abilitare metodi di pagamento locali per Paese
    Metodi di pagamento personalizzati
Gestire i metodi di pagamento
Pagare più velocemente con Link
Interfacce di pagamento
Payment Links
Checkout
Elements per il Web
Elements in-app
Scenari di pagamento
Flussi di pagamento personalizzati
Acquisizione flessibile
Orchestrazione
Pagamenti di persona
Terminal
Altri prodotti Stripe
Financial Connections
Criptovaluta
Climate
Pagina inizialePagamentiAdd payment methodsBuy now, pay laterAfterpay / Clearpay

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.

Copia pagina

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à

Area geografica del cliente: Australia, Canada, New Zealand, UK, US

Valute accettate: aud, cad, nzd, gbp, usd

Valute di pagamento: aud, cad, nzd, gbp, usd

Modalità di pagamento: Yes

Modalità di configurazione: No

Modalità di abbonamento: No

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:

  1. Aggiungere afterpay_clearpay all’elenco payment_method_types.
  2. Accertarti che tutte le line_items utilizzino la tua valuta nazionale.
  3. Ti consigliamo di raccogliere gli indirizzi di spedizione aggiungendo il tuo Paese a shipping_address_collection[allowed_countries]. Se non desideri raccogliere gli indirizzi di spedizione con Checkout, puoi anche indicarli utilizzando payment_intent_data[shipping]. Questo aiuta ad aumentare i tassi di accettazione dei prestiti.
Ruby
Stripe::Checkout::Session.create({ mode: 'payment', payment_method_types: ['card'], payment_method_types: ['card', 'afterpay_clearpay'], line_items: [{ price_data: { currency: 'usd', product_data: { name: 'T-shirt', }, # Make sure the total amount fits within Afterpay transaction amount limits: # https://stripe.com/docs/payments/afterpay-clearpay#collection-schedule unit_amount: 2000, }, quantity: 1, }], shipping_address_collection: { # Shipping address is optional but recommended to pass in # Specify which shipping countries Checkout should provide as options for shipping locations allowed_countries: ['AU', 'CA', 'GB', 'NZ', 'US'], }, # If you already have the shipping address, provide it in payment_intent_data: # payment_intent_data: { # shipping: { # name: 'Jenny Rosen', # address: { # line1: '1234 Main Street', # city: 'San Francisco', # state: 'CA', # country: 'US', # postal_code: '94111', # }, # }, # }, success_url: 'https://example.com/success', cancel_url: 'https://example.com/cancel', })

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 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_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

  • Ulteriori informazioni su Afterpay
  • Completamento del pagamento
  • Personalizzazione di Checkout
Questa pagina è stata utile?
SìNo
Hai bisogno di aiuto? Contatta l'assistenza clienti.
Partecipa al nostro programma di accesso anticipato.
Dai un'occhiata al nostro registro delle modifiche.
Domande? Contattaci.
LLM? Leggi llms.txt.
Realizzato da Markdoc