Facturer la livraison

Une fois le paiement aboutit, vous pouvez récupérer le montant de la livraison dans l’attribut amount_total de shipping_cost. Vous pouvez également récupérer le tarif de livraison sélectionné à l’aide de l’attribut shipping_rate de shipping_cost. Pour accéder à la propriété shipping_cost, vous devez créer un gestionnaire d’événements pour gérer les sessions Checkout terminées. Vous pouvez tester un gestionnaire en installant la CLI Stripe et en utilisant stripe listen --forward-to localhost:4242/webhook pour transférer les événements vers votre serveur local. Dans l’exemple de code suivant, le gestionnaire permet à l’utilisateur d’accéder à shipping_property :

# 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

Vous pouvez configurer des tarifs de livraison avec différentes combinaisons d’estimations du délai de livraison. Le tableau suivant présente des exemples d’estimations, avec leurs valeurs delivery_estimate.minimum et delivery_estimate.maximum correspondantes :

{
  unit: 'day',
  value: 1,
}

{
  unit: 'day',
  value: 1,
}

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

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

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

null

{
  unit: 'day',
  value: 3,
}

{
  unit: 'day',
  value: 7,
}

{
  unit: 'hour',
  value: 4,
}

{
  unit: 'hour',
  value: 8,
}

{
  unit: 'hour',
  value: 4,
}

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

Vous pouvez utiliser Stripe Tax pour calculer automatiquement la taxe appliquée aux frais de livraison en définissant un tax_code et un tax_behavior sur vos frais de livraison. Stripe Tax détermine automatiquement si la livraison est imposable (car la fiscalité varie selon l’état et le pays), puis applique le taux de taxe adapté si c’est le cas.

Lors de la création d’un tarif d’expédition avec shipping_rate_data ou par le biais de Create a Shipping Rate, vous pouvez ajouter un paramètre tax_behavior et tax_code au tarif d’expédition.

Nous vous recommandons de définir le tax_code sur Shipping (txcd_92010001) pour vous assurer que vous facturez toujours la juste taxe. Vous pouvez également définir le tax_code du tarif de livraison sur Nontaxable (txcd_00000000) si vous ne souhaitez facturer aucune taxe.

Dans cet exemple, nous définissons le tax_behavior sur exclusive (courant aux États-Unis). Pour plus d’informations, reportez-vous à notre documentation relative au comportement fiscal.

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"

Votre client peut voir le montant de la taxe calculé pour le tarif de livraison pris en compte dans la taxe de vente totale dans votre tunnel de paiement :

Montant de la taxe calculé pour le tarif de livraison dans le tunnel de paiement