Passa al contenuto
Crea account
 o
Accedi
Il logo della documentazione Stripe
/
Crea un account
Accedi
PanoramicaEseguire l'upgrade dell'integrazione
Pagamenti online
PanoramicaTrovare il caso d'uso più adattoManaged Payments
Modalità di pagamento
Interfacce di pagamento
Scenari di pagamento
Pagamenti di persona
Altri prodotti Stripe

Guida alla migrazione di Checkout

Come eseguire la migrazione alle integrazioni più recenti di Stripe.

Copia pagina

Nella versione precedente di Checkout i clienti visualizzavano una finestra di dialogo modale che raccoglieva i dati della carta e restituiva un token o un’origine al tuo sito web. Invece Payment Links e la versione corrente di Checkout sono pagine di pagamento intelligenti in hosting su Stripe che creano pagamenti o abbonamenti. Entrambe le integrazioni supportano Apple Pay, Google Pay, 3D Secure dinamico, Connect, il riutilizzo di clienti esistenti e molte altre funzionalità. Se Payment Links o Checkout non sono adatti al tuo caso d’uso, puoi anche confrontare altre integrazioni per pagamenti.

Prima di iniziare

Se utilizzi gli SDK di Stripe, esegui l’aggiornamento alla versione più recente.

Scegliere il modello di business

Per eseguire la migrazione dalla versione precedente di Checkout, segui la guida che meglio rappresentata il tuo modello di business. Ogni guida consiglia un percorso di integrazione e fornisce un esempio di codice.

Mentre segui le istruzioni della guida alla migrazione pertinente, puoi anche fare riferimento alla tabella di conversione per associare i parametri specifici e le opzioni di configurazione.

Catalogo prodotti e prezzi dinamici

Se vendi prodotti per i quali l’importo o le voci riga vengono determinati in modo dinamico, ad esempio con un vasto catalogo di prodotti o per donazioni, scopri come accettare i pagamenti una tantum.

Probabilmente hai utilizzato la versione precedente di Checkout per creare un token o un’origine sul client, che poi hai specificato sul server per creare un addebito.Nella versione corrente di Checkout questo flusso è invertito. Prima crei una sessione sul server, reindirizzi il cliente su Checkout, che a sua volta viene reindirizzato all’applicazione dopo il pagamento.

Prima

Con la versione precedente di Checkout, visualizzeresti l’importo e la descrizione dinamici e raccoglieresti i dati della carta del cliente.

client.html
<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Custom t-shirt"
    data-description="Your custom designed t-shirt"
    data-amount="{{ORDER_AMOUNT}}"
    data-currency="usd">
  </script>
</form>

Poi invieresti al server il token o l’origine risultanti per effettuare l’addebito.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="Custom t-shirt" \
  -d "amount"="{{ORDER_AMOUNT}}" \
  -d "currency"="usd"

Dopo

Aggiungi sul tuo sito web un pulsante di pagamento che richiami un endpoint lato server per creare una sessione di Checkout.

checkout.html
<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:

Includi un success_url con l’URL di una pagina del tuo sito web a cui il cliente viene reindirizzato una volta che ha completato il pagamento.

Command Line
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]"="Custom t-shirt" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Dopo aver creato una sessione di Checkout, reindirizza il cliente all’URL restituito nella risposta. Se hai bisogno di evadere i prodotti acquistati dopo il pagamento, consulta Pagamenti tramite Checkout e Payment Link.

Abbonamenti dinamici

Se fornisci servizi di abbonamento che vengono determinati in modo dinamico o che richiedono il supporto di altre funzionalità avanzate, scopri come configurare un abbonamento.

Probabilmente hai utilizzato la versione precedente di Checkout per creare un token o un’origine sul client, che poi hai specificato sul server per creare un cliente e un abbonamento. Nella versione corrente di Checkout questo flusso è invertito. Prima crei una sessione sul server, reindirizzi il cliente su Checkout, che a sua volta viene reindirizzato all’applicazione una volta completata l’operazione.

Prima

Con la versione precedente di Checkout, visualizzeresti le informazioni sull’abbonamento e raccoglieresti i dati della carta del cliente.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Gold Tier"
    data-description="Monthly subscription with 30 days trial"
    data-amount="2000"
    data-label="Subscribe">
  </script>
</form>

Poi invieresti al server il token o l’origine risultanti per creare un cliente e un abbonamento.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/subscriptions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{PRICE_ID}" \
  -d "trial_period_days"=30

Dopo

Aggiungi sul tuo sito web un pulsante di pagamento che richiami un endpoint lato server per creare una sessione di Checkout.

checkout.html
<html>
  <head>
    <title>Subscribe to cool new service</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">Subscribe</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:

Includi un success_url con l’URL di una pagina del tuo sito web a cui il cliente viene reindirizzato una volta che ha completato il pagamento.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=30 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success"

Dopo aver creato una sessione di Checkout, reindirizza il cliente all’URL restituito nella risposta. Il cliente viene reindirizzato al success_url dopo la creazione del cliente e dell’abbonamento Se hai bisogno di evadere i servizi acquistati dopo il pagamento, consulta Pagamenti tramite Checkout e Payment Link.

Connettere piattaforme e marketplace

Se gestisci una piattaforma o un marketplace Connect e crei pagamenti che coinvolgono gli account connessi, ti consigliamo di utilizzare la versione corrente di Checkout.

Il seguente esempio mostra l’utilizzo dell’API Checkout Sessions per elaborare un addebito diretto. Puoi anche utilizzare Checkout e Connect con addebiti indiretti e addebiti e trasferimenti separati.

Prima

Con la versione precedente di Checkout, raccoglieresti i dati della carta del cliente sul client.

client.html
<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Food Marketplace"
    data-description="10 cucumbers from Roger's Farm"
    data-amount="2000">
  </script>
</form>

Poi invieresti al server il token o l’origine risultanti e addebiteresti l’importo per conto dell’account connesso.

Command Line
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source"="{{TOKEN_ID}}" \
  -d "description"="10 cucumbers from Roger\"s Farm" \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "application_fee_amount"=200 \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}"

Dopo

Aggiungi sul tuo sito web un pulsante di pagamento che richiami un endpoint lato server per creare una sessione di Checkout.

checkout.html
<html>
  <head>
    <title>Roger's Farm</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:

Includi un success_url con l’URL di una pagina del tuo sito web a cui il cliente viene reindirizzato una volta che ha completato il pagamento.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price_data][currency]"=usd \
  --data-urlencode "line_items[0][price_data][product_data][name]"="Cucumbers from Roger's Farm" \
  -d "line_items[0][price_data][unit_amount]"=200 \
  -d "line_items[0][quantity]"=10 \
  -d "payment_intent_data[application_fee_amount]"=200 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Dopo aver creato una sessione di Checkout, reindirizza il cliente all’URL restituito nella risposta. Se hai bisogno di evadere i beni o servizi acquistati dopo il pagamento, consulta Pagamenti tramite Checkout e Payment Link.

Salvare le modalità di pagamento per uso futuro

Se fornisci servizi che non vengono addebitati subito ai clienti, leggi come impostare pagamenti futuri.

Probabilmente hai utilizzato la versione precedente di Checkout per creare un token o un’origine sul client, che poi hai specificato sul server per salvarlo per un uso futuro. Nella versione corrente di Checkout questo flusso è invertito. Prima crei una sessione sul server, reindirizzi il cliente su Checkout, che a sua volta viene reindirizzato all’applicazione una volta completata l’operazione.

Prima

Con la versione precedente di Checkout, visualizzeresti le informazioni sull’addebito e raccoglieresti i dati della carta del cliente.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Cleaning Service"
    data-description="Charged after your home is spotless"
    data-amount="2000">
  </script>
</form>

Poi invieresti al server il token o l’origine risultante per creare successivamente un addebito.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="Cleaning service" \
  -d "amount"="{{ORDER_AMOUNT}}" \
  -d "currency"="usd"

Dopo

Aggiungi sul tuo sito web un pulsante di pagamento che richiami un endpoint lato server per creare una sessione di Checkout.

checkout.html
<html>
  <head>
    <title>Cleaning service</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">Subscribe</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:

Includi un success_url con l’URL di una pagina del tuo sito web a cui il cliente viene reindirizzato una volta che ha completato la configurazione del pagamento.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=setup \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}"

Dopo aver creato una sessione di Checkout, reindirizza il cliente all’URL restituito nella risposta per raccogliere i dettagli del metodo di pagamento. Una volta completato il flusso, il cliente viene reindirizzato a success_url. Per completare la riscossione di un pagamento, recupera il SetupIntent dalla sessione di Checkout e utilizzalo per preparare la transazione.

Catalogo prodotti semplice con prezzi fissi

Se vendi prodotti a prezzo fisso (come t-shirt o e-book), consulta la guida su link di pagamento. Probabilmente hai utilizzato la versione precedente di Checkout per creare un token o un’origine sul client e l’hai trasmessa al server per creare un addebito.

Prima

Con la versione precedente di Checkout, visualizzeresti l’importo e la descrizione e raccoglieresti i dati della carta del cliente.

client.html
<form action="/pay" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="T-shirt"
    data-description="Comfortable cotton t-shirt"
    data-amount="500"
    data-currency="usd">
  </script>
</form>

Poi invieresti al server il token o l’origine risultante per creare un cliente e un addebito.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="{{STRIPE_EMAIL}}" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="T-shirt" \
  -d "amount"=500 \
  -d "currency"="usd"

Dopo

Crea un oggetto Product e un oggetto Price che rappresentano l’articolo. Il seguente esempio crea il prodotto incorporato. Puoi anche creare questi oggetti nella Dashboard.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=500 \
  -d "product_data[name]"=T-shirt

Crea un link di pagamento nella Dashboard utilizzando gli oggetti Prodotto e Prezzo. Dopo aver creato il link, fai clic sul pulsante Acquista per configurare l’aspetto e generare il codice che puoi copiare e incollare nel tuo sito web.

index.html
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
'{{BUY_BUTTON_ID}}'

    publishable-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

  >
  </stripe-buy-button>
</body>

Abbonamenti semplici

Se fornisci un servizio di abbonamento semplice (ad esempio l’accesso mensile a un software), consulta la guida sui link di pagamento. Probabilmente hai utilizzato la versione precedente di Checkout per creare un token o un’origine sul client, che poi hai specificato sul server per creare un cliente e un abbonamento.

Prima

Con la versione precedente di Checkout, visualizzeresti le informazioni sull’abbonamento e raccoglieresti i dati della carta del cliente.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Gold Tier"
    data-description="Monthly subscription"
    data-amount="2000"
    data-currency="usd"
    data-label="Subscribe">
  </script>
</form>

Poi invieresti al server il token o l’origine risultanti per creare un cliente e un abbonamento.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="{{STRIPE_EMAIL}}" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/subscriptions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "items[][price]"="{PRICE_ID}" \
  -d "items[][quantity]"=1

Dopo

Crea un oggetto Product e un oggetto Price che rappresentano l’abbonamento. Il seguente esempio crea il prodotto incorporato. Puoi anche creare questi oggetti nella Dashboard.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=2000 \
  -d "recurring[interval]"=month \
  -d "product_data[name]"="Gold Tier"

Crea un link di pagamento nella Dashboard utilizzando gli oggetti Prodotto e Prezzo. Dopo aver creato il link, fai clic sul pulsante Acquista per configurare l’aspetto e generare il codice che puoi copiare e incollare nel tuo sito web.

index.html
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
'{{BUY_BUTTON_ID}}'

    publishable-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

  >
  </stripe-buy-button>
</body>

Conversione dei parametri

La versione corrente di Checkout supporta la maggior parte delle funzionalità della versione precedente di Checkout. Tuttavia, non condividono la stessa API. La tabella riportata di seguito mostra la corrispondenza dei parametri e delle opzioni di configurazione della versione precedente e della versione corrente. Per un elenco completo delle opzioni di configurazione, consulta sessioni di Checkout.

Versione precedenteVersione correnteSuggerimenti per l’integrazione
allowRememberMeNon supportatoRiutilizza i clienti esistenti specificando il parametro customer durante la creazione di una sessione di checkout. Puoi anche abilitare Link per consentire ai clienti di salvare e riutilizzare in sicurezza i dati di pagamento.
amountCalcolato automaticamente come somma degli importi di tutti i parametri line_itemsL’importo totale è la somma delle voci riga specificate in Checkout.
billingAddressSession.billing_address_collectionCheckout raccoglie automaticamente l’indirizzo di fatturazione se è obbligatorio per prevenire le frodi o a fini normativi. Per raccogliere sempre l’indirizzo di fatturazione, imposta questo parametro su required.
closedcancel_urlSe un cliente vuole chiudere Checkout, deve chiudere la scheda del browser o selezionare cancel_url.
currencySession.currency
descriptionSession.line_items.description o product.descriptionSe specifichi un prezzo, Checkout genera una descrizione automatica della frequenza dei pagamenti. Se specifichi il parametro Session.line_items, Checkout visualizza il nome di ogni voce riga nel parametro name.
emailSession.customer_emailSe conosci già l’indirizzo email del cliente, puoi precompilarlo con customer_email quando crei la sessione di Checkout.

image

Branding dell’attività: carica il logo o l’icona della tua attività nella Dashboard.

Immagini prodotto: specifica le immagini di ogni voce riga con product.images.

Checkout utilizza immagini specifiche per il branding della tua azienda e per i prodotti che vendi. Checkout mostra il logo dell’azienda per impostazione predefinita e recupera l’icona e il nome della tua azienda.

keyParametro non più specificato in Checkout
localeSession.localeDurante la creazione di una sessione di Checkout, puoi specificare le impostazioni locali.
nameproduct.name per i prezzi specificati in Session.line_itemsSe specifichi un prezzo, Checkout mostra il nome del prodotto a cui appartiene il prezzo. Se specifichi il parametro Session.line_items, Checkout mostra il nome di ogni voce riga nel parametro name.
panelLabelsubmit_typeCheckout personalizza automaticamente il testo del pulsante a seconda degli articoli che vendi. Per i pagamenti una tantum, utilizza submit_type per personalizzare il testo del pulsante.
shippingAddresssession.shipping_address_collectionRaccogli le informazioni sull’indirizzo di spedizione specificando una matrice di allowed_countries autorizzati per le spedizioni.
token o sourcesuccess_urlIn JavaScript non è più disponibile una richiamata una volta completato il pagamento. Dato che il cliente paga su una pagina diversa, imposta success_url per reindirizzare il cliente sulla pagina di conferma dopo che ha completato il pagamento.
zipCodeRaccolto automaticamente da CheckoutCheckout raccoglie automaticamente il codice postale se richiesto per prevenire le frodi o a fini normativi.

Vedi anche

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