Débiter la livraison

Une fois le paiement effectué, vous pouvez récupérer le montant des frais de livraison dans l’attribut amount_total de shipping_cost. Vous pouvez également récupérer les tarifs de livraison sélectionnés à l’aide de l’attribut shipping_rate dans 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 l’interface de ligne de commande Stripe et en utilisant stripe listen --forward-to localhost:4242/webhook pour transférer les événements à 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 les tarifs de livraison à l’aide de différentes combinaisons de 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 sur les frais de livraison en définissant un tax_code et un tax_behavior sur vos tarifs de livraison. Stripe Tax détermine automatiquement si les frais de livraison sont taxables (car l’assujettissement à la taxe varie selon l’État et le pays) et applique le bon taux de taxe, le cas échéant.

Lorsque vous créez un tarif de livraison avec shipping_rate_data ou par l’entremise de Créer un tarif de livraison, vous pouvez ajouter un paramètre tax_behavior et tax_code au tarif de livraison.

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 tarif de livraison tax_code sur Nontaxable (txcd_00000000) si vous ne souhaitez facturer aucune taxe.

Dans cet exemple, nous définissons tax_behavior à exclusive, ce qui est courant aux États-Unis. En savoir plus sur le 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 des taxes calculé pour le tarif de livraison pris en compte dans le total de la taxe de vente dans votre flux de paiement :

Montant des taxes calculé pour le tarif de livraison dans le flux de paiement