Passa al contenuto
Crea account o Accedi
Il logo della documentazione Stripe
/
Crea un accountAccedi
PanoramicaEseguire l'upgrade dell'integrazione
Pagamenti online
PanoramicaTrovare il caso d'uso più adattoUsa Managed Payments
Pagamenti di persona
Metodi di pagamento
Scenari di pagamento
Oltre i pagamenti

Addebitare la spedizione

Creare costi di spedizione diversi per i clienti

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.

Creare un costo di spedizione
Dashboard
Lato server

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:

  1. Fai clic su Crea costo di spedizione.
  2. Inserisci un importo, una descrizione e una data di consegna prevista (facoltativa).
  3. Fai clic su Salva e copia l’ID del costo di spedizione (shr_123456).

Inserisci i dettagli del costo di spedizione

Aggiornare un costo di spedizione

Non puoi aggiornare un costo di spedizione nella Dashboard. Per aggiornare un costo di spedizione nella Dashboard, devi archiviarlo e crearne uno nuovo.

Archiviare un costo di spedizione

Per archiviare un costo di spedizione:

  1. Nella scheda Costi di spedizione, seleziona il costo di spedizione applicabile.
  2. Fai clic sul menu extra e seleziona Archivia.

Per annullare l’archiviazione del costo di spedizione, fai clic sul menu extra e seleziona Annulla archiviazione costo di spedizione.

Creare una sessione di Checkout
Lato server

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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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"

If successful, the shipping selector appears in your checkout flow:

The shipping selector in the checkout flow

The shipping selector in the checkout flow

FacoltativoGestire le transazioni completate

Una volta completato il pagamento, puoi recuperare l’importo della spedizione nell’attributo amount_total di shipping_cost. Puoi anche recuperare il costo di spedizione selezionato utilizzando l’attributo shipping_rate in shipping_cost. Per accedere alla proprietà shipping_cost, devi creare un gestore eventi per gestire le sessioni di Checkout completate. Puoi eseguire il test di un gestore installando la CLI di Stripe e utilizzando stripe listen --forward-to localhost:4242/webhook per inoltrare gli eventi al tuo server locale. Nell’esempio di codice seguente, il gestore consente all’utente di accedere a shipping_property:

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
"sk_test_BQokikJOvBiI2HlWgH4olfQ2"


require 'sinatra'

# You can find your endpoint's secret in your webhook settings
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  if event['type'] == 'checkout.session.completed'
    checkout_session = event['data']['object']

    fulfill_order(checkout_session)
  end

  status 200
end

def fulfill_order(checkout_session)
  selected_shipping_rate = Stripe::ShippingRate.retrieve(checkout_session.shipping_cost.shipping_rate)
  shipping_total = checkout_session.shipping_cost.amount_total

  # TODO: Remove error and implement...
  raise NotImplementedError.new(<<~MSG)
    Given the Checkout Session "#{checkout_session.id}" load your internal order from the database then implement your own fulfillment logic.
  MSG
end

FacoltativoDefinire una data di consegna prevista

Puoi configurare le tariffe di spedizione utilizzando più combinazioni di stime di consegna. La tabella seguente contiene alcuni esempi di stime di consegna descritte in italiano e i corrispondenti valori delivery_estimate.minimum e delivery_estimate.maximum:

Stima di consegnaMinimoMassimo
1 giorno
{
  unit: 'day',
  value: 1,
}

{
  unit: 'day',
  value: 1,
}
1 giorno lavorativo
{
  unit: 'business_day',
  value: 1,
}

{
  unit: 'business_day',
  value: 1,
}
Almeno 2 giorni lavorativi
{
  unit: 'business_day',
  value: 2,
}

null
Da 3 a 7 giorni
{
  unit: 'day',
  value: 3,
}

{
  unit: 'day',
  value: 7,
}
Da 4 a 8 ore
{
  unit: 'hour',
  value: 4,
}

{
  unit: 'hour',
  value: 8,
}
Da 4 ore a 2 giorni lavorativi
{
  unit: 'hour',
  value: 4,
}


{
  unit: 'business_day',
  value: 2,
}

FacoltativoAddebitare le imposte per la spedizione

Puoi usare Stripe Tax per calcolare automaticamente le imposte sulle spese di spedizione impostando tax_code e tax_behavior nel tuo costo di spedizione. Stripe Tax determina automaticamente se la spedizione è tassabile (poiché l’imponibilità varia da Stato e Paese) e, nel caso, applica l’aliquota fiscale corretta.

Durante la creazione di un costo di spedizione con shipping_rate_data o tramite Crea costo di spedizione, puoi aggiungere al costo di spedizione un parametro tax_behavior e tax_code.

Ti consigliamo di impostare tax_code su Shipping (txcd_92010001) per avere la sicurezza di addebitare l’imposta corretta. Puoi anche impostare il tax_code del costo di spedizione su Nontaxable (txcd_00000000) se non intendi applicare imposte.

In questo esempio, impostiamo tax_behavior su exclusive, che è comune negli Stati Uniti. Ulteriori informazioni sul comportamento fiscale.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d billing_address_collection=required \
  -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][tax_behavior]"=exclusive \
  -d "shipping_options[0][shipping_rate_data][tax_code]"=txcd_92010001 \
  -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 "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][price_data][tax_behavior]"=exclusive \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Your customer can see the calculated tax amount for the shipping rate factored into the total sales tax in your checkout flow:

Importo dell'imposta calcolato per il costo di spedizione nella pagina di pagamento

Calculated tax amount for the shipping rate in the checkout flow

Questa pagina è stata utile?
SìNo