Pour ajouter un tarif de livraison à l’aide du Dashboard :
- Cliquez sur Créer des frais de livraison.
- Renseignez un montant, une description et, si vous le souhaitez, une estimation du délai de livraison.
- Cliquez sur Enregistrer et copiez l’ID des frais de livraison (
shr_123456
).
Saisir les détails de votre tarif de livraison
Créer une session Checkout
Pour créer une session de paiement incluant vos frais de livraison, transmettez l’ID des frais de livraison généré au paramètre shipping_options. Si vous souhaitez créer les frais de livraison en même temps qu’une session Checkout, utilisez le paramètre shipping_rate_data
avec shipping_options
. Seules les sessions Checkout en mode de paiement prennent en charge les options de livraison.
L’exemple de code suivant permet d’ajouter deux options de livraison à la session Checkout :
- Livraison gratuite sous 5 à 7 jours ouvrés (estimation).
- Livraison par voie aérienne sous 1 jour ouvré (estimation) pour un coût de 15,00 USD.
Dans cet exemple, la première option du tableau shipping_options
est sélectionnée par défaut lorsque le client accède à la page de paiement. Les clients peuvent cependant choisir ensuite l’option de leur choix.
curl https://api.stripe.com/v1/checkout/sessions \
-u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
-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" \
--data-urlencode cancel_url="https://example.com/cancel"
Sauf échec de l’opération, le sélecteur d’option de livraison apparaît sur votre page de paiement :
Le sélecteur d’option de livraison sur la page de paiement