Accettare un pagamento
Build a payment form or use a prebuilt checkout page to start accepting online payments.
Reindirizza a una pagina di pagamento in hosting su Stripe Checkout. Confronta questa integrazione con gli altri tipi di integrazione di Stripe.
Sforzo di integrazione
Tipo di integrazione
Reindirizzare alla pagina di pagamento in hosting su Stripe
Personalizzazione dell'interfaccia utente
Configurare StripeLato server
Innanzitutto registrati per creare un account Stripe.
Utilizza le nostre librerie ufficiali per accedere all’API Stripe dalla tua applicazione:
Reindirizzare il cliente a Stripe CheckoutLato clientLato server
Aggiungi sul tuo sito web un pulsante di pagamento che richiami un endpoint lato server per creare una sessione di Checkout.
<html> <head> <title>Buy cool new product</title> </head> <body> <!-- Use action="/create-checkout-session.php" if your server is PHP based. --> <form action="/create-checkout-session" method="POST"> <button type="submit">Checkout</button> </form> </body> </html>
Una sessione di Checkout è una rappresentazione programmatica di quello che il cliente visualizza quando viene reindirizzato al modulo di pagamento. Puoi configurarlo con le seguenti opzioni:
- Voci riga da addebitare
- Valute da utilizzare
Devi anche specificare success_url
, una pagina del tuo sito web a cui Checkout rimanda il cliente una volta che ha completato il pagamento. Facoltativamente, puoi specificare cancel_url
, una pagina del tuo sito web a cui Checkout rimanda il cliente se annulla la procedura di pagamento.
Nota
Le sessioni di Checkout scadono 24 ore dopo la creazione.
Dopo aver creato una sessione di Checkout, reindirizza il cliente all’URL restituito nella risposta.
Nota
Per impostazione predefinita, Stripe abilita le carte e altre modalità di pagamento principali per aiutarti a raggiungere più clienti, ma tu potrai attivare o disattivare le modalità direttamente dalla Dashboard Stripe. Stripe esamina la valuta, le limitazioni delle modalità di pagamento e altri parametri per preparare un elenco di modalità di pagamento supportate da mostrarti in Checkout.
Per eseguire il test dell’endpoint, avvia il server web (ad esempio, localhost:4242
) ed esegui il seguente comando:
curl -X POST -is "http://localhost:4242/create-checkout-session" -d ""
Il terminale mostra una risposta simile alla seguente:
HTTP/1.1 303 See Other Location: https://checkout.stripe.com/c/pay/cs_test_... ...
Test
Adesso dovresti avere un pulsante di pagamento funzionante che reindirizza il cliente a Stripe Checkout.
- Fai clic sul pulsante di pagamento.
- Vieni reindirizzato al modulo di pagamento di Stripe Checkout.
Se l’integrazione non funziona:
- Apri la scheda Rete negli strumenti per sviluppatori del browser.
- Fai clic sul pulsante di pagamento e conferma l’invio della richiesta XHR all’endpoint lato server (
POST /create-checkout-session
). - Verifica che la richiesta restituisca uno stato 200.
- Utilizza
console.log(session)
nel listener del clic sul pulsante per confermare la restituzione dei dati appropriati.
Per vedere come i clienti visualizzano le tue modalità di pagamento, inserisci un ID transazione o imposta l’importo e la valuta dell’ordine nella Dashboard.
Mostrare una pagina di confermaLato clientLato server
È importante mostrare al cliente una pagina di conferma dopo che ha inviato il modulo di pagamento. Ospita questa pagina di conferma sul tuo sito.
Crea una pagina di conferma minima:
<html> <head><title>Thanks for your order!</title></head> <body> <h1>Thanks for your order!</h1> <p> We appreciate your business! If you have any questions, please email <a href="mailto:orders@example.com">orders@example.com</a>. </p> </body> </html>
Poi aggiorna l’endpoint per la creazione della sessione di Checkout in modo tale che utilizzi la nuova pagina:
Nota
Se vuoi personalizzare la pagina di conferma, consulta la guida dedicata alla personalizzazione della pagina di conferma.
Test
- Fai clic sul pulsante di pagamento.
- Compila i dettagli di pagamento con i dati della carta di test:
- Inserisci
4242 4242 4242 4242
come numero della carta. - Inserisci una data futura qualsiasi come scadenza della carta.
- Inserisci un numero di 3 cifre per il CVC.
- Inserisci un qualsiasi codice postale.
- Inserisci
- Fai clic su Paga.
- Verrai reindirizzato alla nuova pagina di conferma.
Poi individua il pagamento nella Dashboard Stripe. I pagamenti riusciti sono visualizzati nell’elenco dei pagamenti della Dashboard. Se fai clic su un pagamento, vieni reindirizzato alla pagina dei dettagli del pagamento. La sezione Riepilogo Checkout contiene le informazioni di addebito e l’elenco degli articoli acquistati, che puoi utilizzare per evadere l’ordine manualmente.
Esegui il test della tua integrazione
Per testare l’integrazione del modulo di pagamento in hosting su Stripe:
- Crea una sessione di Checkout.
- Compila i dettagli di pagamento con una delle modalità indicate nella tabella di seguito.
- Inserisci una data di scadenza futura per la carta.
- Inserisci un numero di 3 cifre per il CVC.
- Inserisci un qualsiasi codice postale.
- Fai clic su Paga. Verrai reindirizzato al tuo
success_url
. - Vai alla Dashboard e cerca il pagamento nella Pagina dei pagamenti. Se il pagamento è andato a buon fine, lo vedrai nell’elenco.
- Fai clic sul pagamento per visualizzare ulteriori dettagli, come il riepilogo di Checkout con i dati di addebito e l’elenco degli articoli acquistati. Puoi utilizzare queste informazioni per evadere l’ordine.
Scopri di più su come testare la tua integrazione.
Per ulteriori informazioni su come testare la tua integrazione, consulta la sezione Test.
Carte di test
Numero | Descrizione |
---|---|
La transazione ha esito positivo e il pagamento viene elaborato automaticamente. | |
Richiede un’autenticazione 3D Secure 2 per la corretta esecuzione del pagamento. | |
Con un codice di rifiuto insufficient_funds , la transazione ha sempre esito negativo. |
Apple Pay e Google Pay
Puoi abilitare Apple Pay e Google Pay nelle impostazioni delle modalità di pagamento. Apple Pay è abilitato per impostazione predefinita.
Per abilitare Apple Pay o Google Pay, non è necessario apportare modifiche all’integrazione delle pagine in hosting su Stripe Checkout. Stripe gestisce questi pagamenti come gli altri pagamenti con carta.
Una volta che l’integrazione di base funziona, scopri come ricevere una notifica in modo programmatico ogni volta che un cliente effettua un pagamento.