Accettare un pagamento
Build a payment form or use a prebuilt checkout page to start accepting online payments.
Incorpora un modulo di pagamento preintegrato sul tuo sito utilizzando Stripe Checkout. Confronta questa integrazione con gli altri tipi di integrazione di Stripe.
Sforzo di integrazione
Tipo di integrazione
Incorporare un modulo di pagamento preintegrato nel tuo sito
Personalizzazione dell'interfaccia utente
Utilizza le impostazioni di branding nella Dashboard Stripe per abbinare Checkout al design del tuo sito.
Configurare StripeLato server
Innanzitutto registrati per creare un account Stripe.
Utilizza le nostre librerie ufficiali per accedere all’API Stripe dalla tua applicazione:
Creare una sessione di CheckoutLato server
Dal tuo server, crea una sessione di Checkout e imposta ui_mode su embedded
. Puoi configurare la sessione di checkout con voci riga per includere opzioni come currency.
Per riportare i clienti a una pagina personalizzata che ospiti sul tuo sito, specifica l’URL della pagina nel parametro return_url. Includi la variabile del modello {CHECKOUT_SESSION_ID}
nell’URL per recuperare lo stato della sessione nella pagina di ritorno. Checkout sostituisce automaticamente la variabile con l’ID della sessione di Checkout prima del reindirizzamento.
Read more about configuring the return page and other options for customizing redirect behavior.
Dopo aver creato la sessione di Checkout, utilizza il parametro client_secret
restituito nella risposta a mount Checkout.
Monta CheckoutLato client
Checkout renders in an iframe that securely sends payment information to Stripe over an HTTPS connection.
Errore comune
Avoid placing Checkout within another iframe because some payment methods require redirecting to another page for payment confirmation.
Personalizza l’aspetto
Personalizza Checkout in base al design del tuo sito impostando il colore di sfondo, il colore dei pulsanti, il raggio del bordo e i caratteri nelle impostazioni di branding del tuo account.
Per impostazione predefinita, Checkout viene visualizzato senza spaziatura aggiuntiva o margine. Per applicare il margine desiderato, ad esempio 16 px su tutti i lati, consigliano di utilizzare un elemento contenitore, ad esempio div.
Mostrare una pagina di reso
Dopo che il cliente ha tentato di effettuare il pagamento, Stripe lo reindirizza a una pagina di ritorno che ospiti sul tuo sito. Quando hai creato la sessione di Checkout, hai specificato l’URL della pagina di ritorno nel parametro return_url. Per ulteriori informazioni in merito, consulta le opzioni di personalizzazione del comportamento di reindirizzamento.
Durante la visualizzazione della pagina di reso, recupera lo stato della sessione di Checkout utilizzando l’ID della sessione di Checkout nell’URL. Gestisci il risultato in base allo stato della sessione come segue:
complete
: il pagamento è andato a buon fine. Utilizza le informazioni della sessione di Checkout per visualizzare una pagina di conferma.open
: il pagamento non è riuscito o è stato annullato. Rimonta Checkout in modo che il cliente possa riprovare.
const session = await fetch(`/session_status?session_id=${session_id}`) if (session.status == 'open') { // Remount embedded Checkout } else if (session.status == 'complete') { // Show success page // Optionally use session.payment_status or session.customer_email // to customize the success page }
Modalità di pagamento con reindirizzamento
Durante il pagamento, alcune modalità di pagamento reindirizzano il cliente a una pagina intermedia, ad esempio una pagina di autorizzazione bancaria. Una volta completata la pagina, Stripe lo reindirizza alla pagina di ritorno.
Scopri ulteriori dettagli sulle modalità di pagamento con reindirizzamento e sul comportamento di reindirizzamento.
Esegui il test della tua integrazione
Per testare l’integrazione del modulo di pagamento incorporato:
- Crea una sessione Checkout incorporata e monta Checkout nella tua pagina.
- 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
return_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.