Non vuoi eseguire la migrazione? Puoi continuare a utilizzare l’integrazione corrente, ma le nuove funzionalità non sono supportate. Qualsiasi nuovo piano o prezzo ricorrente che crei può essere utilizzato nel parametro plan delle chiamate API esistenti.
Panoramica di prodotti e prezzi
I prezzi sono una nuova entità principale in Stripe che funziona con abbonamenti, fatture e Checkout. Ogni prezzo è associato a un singolo prodotto e ogni prodotto può avere più prezzi. Beni fisici o livelli di servizio diversi devono essere rappresentati da prodotti. Le tariffe di tali prodotti devono essere rappresentate da prezzi.
I prezzi definiscono prezzo di base, valuta e, per i prodotti ricorrenti, ciclo di addebito. Questo ti consente di modificare e aggiungere i prezzi senza dover modificare i dettagli di ciò che offri. Ad esempio, potresti commercializzare un solo prodotto di fascia “gold” i cui prezzi corrispondono a 10 USD/mese, 100 USD/anno, 9 EUR/mese e 90 EUR/anno oppure una T-shirt blu con prezzi pari a 20 USD e 15 EUR.
Piani e SKU (solo client) possono essere utilizzati con la nuova integrazione ogni volta che i prezzi sono accettati. Puoi anche creare un prodotto e un prezzo attraverso l’API o la Dashboard.
Pagamenti una tantum
L’integrazione client e server prevede le seguenti modifiche per i pagamenti una tantum:
Anziché voci riga ad hoc (ovvero che prevedono l’impostazione di nome, importo e valuta), la creazione di una sessione di Checkout richiede la creazione di un prodotto e solitamente di un prezzo.
Anziché impostare ogni campo su line_items, Checkout utilizza gli oggetti prodotto e prezzo sottostanti per determinare nome, descrizione, importo, valuta e immagini. Puoi creare prodotti e prezzi con l’API o la Dashboard.
Senza prezzi
Con prezzi
line_items.name
product.name
line_items.description
product.description
line_items.amount
price.unit_amount
price_data.unit_amount (se definito al momento della creazione della sessione di Checkout)
line_items.currency
price.currency
price_data.currency (se definito al momento della creazione della sessione di Checkout)
line_items.images
product.images (visualizza la prima immagine fornita)
Codice lato server per le voci in linea
In precedenza le voci una tantum potevano essere create solo in linea. Con i prezzi, puoi continuare a configurare le voci in linea, ma puoi anche definire i prezzi in modo dinamico con price_data al momento della creazione della sessione di Checkout.
Quando crei la sessione di Checkout con price_data, fai riferimento a un ID prodotto esistente con price_data.product oppure definisci i dettagli del prodotto in modo dinamico utilizzando price_data.product_data. Il seguente esempio illustra il flusso di creazione di una voce una tantum.
Con questa nuova integrazione, puoi creare un catalogo di prodotti e prezzi anticipatamente anziché dover definire importo, valuta e nome ogni volta che crei una sessione di Checkout.
Puoi creare un prodotto e un prezzo con l’API Prices o mediante la Dashboard. Per creare la sessione di Checkout è necessario l’ID prezzo. Il seguente esempio illustra come creare un prodotto e un prezzo tramite l’API:
L’integrazione client e server prevede le seguenti modifiche per i pagamenti ricorrenti:
Tutte le voci sono specificate in un singolo campo line_items anziché subscription_data.items.
La modalità ora è obbligatoria. Imposta mode=subscription se la sessione include voci ricorrenti.
Il codice lato client rimane invariato. I piani esistenti possono essere utilizzati ovunque vengano accettati i pagamenti ricorrenti.
Codice lato server con piani
Di seguito è riportato un esempio di creazione di una sessione di Checkout con una prova e utilizzando un piano esistente in modo intercambiabile con un prezzo. Il piano ora è specificato nel campo line_items anziché subscription_data.items.
Codice lato server per prezzo ricorrente con costo di attivazione
Per i piani ricorrenti con costi di attivazione una tantum, crea il prodotto e il prezzo che rappresentano la commissione una tantum prima di creare la sessione di Checkout. Vedi la tabella delle corrispondenze per informazioni sulle corrispondenze tra i precedenti campi line_items e la nuova integrazione. Puoi creare un prodotto e un prezzo attraverso l’API Prices o la Dashboard Stripe. Puoi anche creare la voce una tantum in linea. Nel seguente esempio viene utilizzato un ID prezzo esistente:
Anziché elencare le voci con display_items, l’oggetto sessione Checkout utilizza line_items. Il campo line_items non viene visualizzato per impostazione predefinita come il campo display_items, ma puoi includerlo utilizzando il parametro expand quando crei una sessione di Checkout:
Poiché line_items può essere incluso, la risposta webhookcheckout.session.completed non elenca più le voci per impostazione predefinita. L’oggetto Response più piccolo ti consente di ricevere i webhook di Checkout più rapidamente. Puoi recuperare le voci con il nuovo endpoint line_items:
Welcome to the Stripe Shell!
Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your
Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe
resources in test mode.
- View supported Stripe commands:
- Find webhook events:
- Listen for webhook events:
- Call Stripe APIs: stripe [api resource] [operation] (e.g., )
La shell di Stripe offre prestazioni ottimali in versione desktop.