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.
L’accettazione di Afterpay nella tua app consiste nella visualizzazione di una vista web con cui il cliente deve autenticare il proprio pagamento. Il cliente torna quindi alla tua app e tu puoi verificare immediatamente se il pagamento ha avuto esito positivo o negativo.
Nota
Prima di avviare l’integrazione, assicurati che il tuo account sia idoneo per Afterpay accedendo alle impostazioni dei metodi di pagamento.
Configura StripeLato serverLato client
Innanzitutto, devi creare un account Stripe. Registrati ora.
Lato server
Per questa integrazione sono necessari endpoint sul server che comunicano con l’API Stripe. Utilizza le nostre librerie ufficiali per accedere all’API Stripe dal tuo server:
Lato client
L’SDK per Android di Stripe è open source e completamente documentato.
Per installare l’SDK, aggiungi stripe-android
al blocco dependencies
del tuo file app/build.gradle:
Nota
Per ulteriori informazioni sulla versione più recente e su quelle precedenti dell’SDK, consulta la pagina Releases su GitHub. Per ricevere una notifica quando viene pubblicata una nuova versione, imposta il controllo delle versioni per il repository.
Configura l’SDK con la tua chiave pubblicabile di Stripe in modo che possa inviare le richieste all’API Stripe, ad esempio nella sottoclasse Application
:
Nota
Usa le chiavi di test durante i test e le chiavi della modalità live quando pubblichi l’app.
I nostri esempi di codice Stripe utilizzano inoltre OkHttp e GSON per inviare richieste HTTP a un server.
Creare un PaymentIntentLato serverLato client
Un PaymentIntent è un oggetto che rappresenta la tua intenzione di riscuotere un pagamento da un cliente e traccia il ciclo di vita del processo di pagamento in ogni sua fase.
Lato server
Innanzitutto crea un PaymentIntent
sul tuo server e specifica l’importo da riscuotere e la valuta. Se hai già un’integrazione che utilizza l’API Payment Intents, aggiungi afterpay_
all’elenco dei tipi di metodi di pagamento per il tuo PaymentIntent
.
Altre opzioni delle modalità di pagamento
Puoi specificare un parametro reference
facoltativo nelle opzioni dei metodi di pagamento per il tuo PaymentIntent
che imposta un identificativo interno dell’ordine per il pagamento. Sebbene queste informazioni non siano generalmente visibili né all’attività né al cliente, il team di assistenza interno di Afterpay può accedervi durante le richieste di assistenza manuali. L’identificatore ha un limite di 128 caratteri e può contenere solo lettere, cifre, caratteri di sottolineatura, barre rovesciate e trattini.
Lato client
Nel PaymentIntent restituito è presente una chiave privata client, che il client può utilizzare per completare la procedura di pagamento in modo sicuro anziché specificare tutto l’oggetto PaymentIntent. Sul lato client, richiedi un PaymentIntent dal tuo server e memorizza la chiave privata client.
Raccogliere i dati relativi alla modalità di pagamentoLato client
Perché il pagamento vada a buon fine, Afterpay ha bisogno che siano presenti i dati di fatturazione. Nella tua app, acquisisci dal cliente i dati di fatturazione necessari:
- Nome e cognome
- Indirizzo email
- Indirizzo di fatturazione completo
Crea un PaymentMethodCreateParams con questi dati.
Inoltre, anche se i dettagli di spedizione non sono obbligatori, possono aiutare a migliorare i tassi di autenticazione. Per raccogliere i dettagli di spedizione, acquisisci dal cliente quanto segue:
- Nome completo
- Indirizzo di spedizione completo
Crea un ConfirmPaymentIntentParams.Shipping con questi dati.
Inviare il pagamento a StripeLato client
Recupera la chiave privata client dal PaymentIntent che hai creato nel passaggio 2 e chiama il metodo PaymentLauncher confirm. Verrà visualizzata una vista web dove il cliente potrà completare il pagamento sul sito web o sull’app della propria banca. In seguito, viene chiamato onActivityResult con il risultato del pagamento.
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. |