I costi di spedizione ti consentono di visualizzare varie opzioni di spedizione (ad es. standard, express o entro il giorno successivo), con stime di consegna più precise. Addebita al tuo cliente la spedizione utilizzando prodotti Stripe diversi. Prima di creare un costo di spedizione, scopri come raccogliere gli indirizzi di fatturazione e di spedizione.
Nota
I costi di spedizione supportano solo valori di importo fisso per l’intero ordine. Non puoi modificare il costo di spedizione in base al numero di articoli nell’ordine.
Nota
I costi di spedizione supportano solo valori di importo fisso per l’intero ordine. Non puoi modificare il costo di spedizione in base al numero di articoli nell’ordine.
Aggiungere un costo di spedizione utilizzando la Dashboard:
- Fai clic su Crea costo di spedizione.
- Inserisci un importo, una descrizione e una data di consegna prevista (facoltativa).
- Fai clic su Salva e copia l’ID del costo di spedizione (
shr_123456
).

Inserisci i dettagli del costo di spedizione
Per creare una sessione di Checkout che includa il tuo costo di spedizione, specifica l’ID del costo di spedizione generato nel parametro shipping_options. Se vuoi creare il costo di spedizione contemporaneamente a una sessione di Checkout, utilizza il parametro shipping_rate_data
con shipping_options
. Solo le sessioni di Checkout in metodo di pagamento supportano le opzioni di spedizione.
Il seguente esempio di codice aggiunge due opzioni di spedizione alla sessione di Checkout:
- Spedizione gratuita, con consegna stimata in 5-7 giorni lavorativi.
- Giorno successivo, a un costo di 15,00 USD, con consegna stimata in 1 giorno lavorativo esatto.
In questo esempio, la prima opzione nella matrice shipping_options
è preselezionata per il cliente nella pagina di pagamento. Tuttavia, i clienti possono scegliere una delle due opzioni.
curl https://api.stripe.com/v1/checkout/sessions \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
-d "shipping_address_collection[allowed_countries][0]"=US \
-d "shipping_address_collection[allowed_countries][1]"=CA \
-d "shipping_options[0][shipping_rate_data][type]"=fixed_amount \
-d "shipping_options[0][shipping_rate_data][fixed_amount][amount]"=0 \
-d "shipping_options[0][shipping_rate_data][fixed_amount][currency]"=usd \
-d "shipping_options[0][shipping_rate_data][display_name]"="Free shipping" \
-d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]"=business_day \
-d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]"=5 \
-d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]"=business_day \
-d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]"=7 \
-d "shipping_options[1][shipping_rate_data][type]"=fixed_amount \
-d "shipping_options[1][shipping_rate_data][fixed_amount][amount]"=1500 \
-d "shipping_options[1][shipping_rate_data][fixed_amount][currency]"=usd \
-d "shipping_options[1][shipping_rate_data][display_name]"="Next day air" \
-d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][unit]"=business_day \
-d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][value]"=1 \
-d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][unit]"=business_day \
-d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][value]"=1 \
-d "line_items[0][price_data][currency]"=usd \
-d "line_items[0][price_data][product_data][name]"=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"
In caso di esito positivo, il selettore di spedizione viene visualizzato nella pagina di pagamento:

Il selettore di spedizione nella pagina di pagamento