Commandes à coût zéro

Vous pouvez vous pouvez traiter les commandes à coût zéro en tant que paiements ponctuels avec des postes à coût zéro ou des réductions de 100 % avec des bons de réduction et des codes promotionnels destinés aux clients.

Créer une session Checkout avec des postes gratuits

Créez un tarif avec un unit_amount de 0, et transmettez-le dans le tableau line items de la session Checkout. Reportez-vous à Produits et tarifs pour en savoir plus sur la création de tarifs.

Vous pouvez également utiliser le paramètre price_data du tableau line_items pour transmettre un tarif gratuit.

Si le montant total est égal à 0, Checkout ne collecte pas le moyen de paiement du client.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=0 \
  -d "line_items[0][price_data][product_data][name]"="Free t-shirt" \
  -d "line_items[0][price_data][currency]"=usd \
  -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"

Si la propriété customer n’est pas définie, la session Checkout crée automatiquement un objet Customer. Cela signifie que les clients invités ne sont pas pris en charge.

Créer une réduction

Vous pouvez également créer un bon de réduction et un code promotionnel pour permettre à vos clients de finaliser leur commande gratuitement.

Créer un bon de réduction

Créez un bon de réduction grâce auquel votre session Checkout sera gratuite. Par exemple, vous pouvez créer un bon de réduction de 100 %.

curl https://api.stripe.com/v1/coupons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d percent_off=100 \
  -d duration=once

Pour créer une session avec une remise appliquée, transmettez l’ID du bon de réduction dans le paramètre coupon du tableau discounts.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][quantity]"=1 \
  -d "discounts[0][coupon]"=
{{COUPON_ID}} \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Vous pouvez également créer une session Checkout gratuite en appliquant un bon de réduction d’un montant égal ou supérieur au total de la session Checkout.

Créer un code promotionnel

Les codes promotionnels sont des codes destinés aux clients, créés en plus des bons de réduction. Vous pouvez les partager avec les clients, qui devront les saisir dans Checkout pour appliquer une ristourne. Créez un code promotionnel à partir d’un bon de réduction de 100 % pour permettre aux clients de créer des commandes gratuitement.

curl https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d coupon=
{{COUPON_ID}} \
  -d code=FREECODE

Activez les codes promotionnels utilisables par l’utilisateur à l’aide du paramètre allow_promotion_codes dans une session Checkout. Un champ est ainsi activé dans Checkout qui permet aux utilisateurs de saisir leurs codes promotionnels.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d allow_promotion_codes=true \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Les clients peuvent également avoir un montant nul à payer s’ils appliquent un code promotionnel leur donnant droit à une réduction d’un montant égal ou supérieur au total de la session Checkout. Pour découvrir d’autres façons d’appliquer des ristournes, consultez Ajouter des ristournes.

Traiter les commandes finalisées

Une fois la session Checkout terminée, vous pouvez lancer une requête sur les postes finalisés et leurs quantités. Si votre client supprime un poste de facture, celui-ci est également supprimé de la réponse relative aux postes. Consultez le guide d’exécution pour apprendre à créer un gestionnaire d’événements pour traiter les sessions Checkout terminées.

Vous pouvez consulter vos commandes à coût zéro finalisées dans le Dashboard. L’onglet Commandes à coût zéro ne s’affiche que si vous avez au moins une commande à coût zéro finalisée.