Commandes à coût zéro

Avec Checkout, vous pouvez traiter les commandes à coût zéro en tant que paiements ponctuels. Si le montant total est égal à 0, Checkout ne collecte pas le moyen de paiement du client.

Limitations

Les commandes à coût zéro ne prennent actuellement pas en charge les clients invités.

Créer une session Checkout Session avec des postes à coût zéro

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.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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"

Créer une ristourne pour permettre à vos clients de finaliser leur commande gratuitement

Bons 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_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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.

Codes promotionnels

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_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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 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 réductions.

Liens de paiement et grilles tarifaires Optional

Par défaut, les liens de paiement et les grilles tarifaires prennent en charge les commandes à coût zéro si votre compte a été créé après le 17 août 2023. Dans le cas des comptes créés avant le 17 août 2023, vous pouvez activer les commandes à coût zéro pour vos liens de paiement et grilles tarifaires en accédant à votre paramètres Checkout dans le Dashboard.

Pour utiliser des commandes à coût zéro avec un lien de paiement en mode test, spécifiez le paramètre d’URL prefilled_email sur une adresse e-mail dont la partie locale inclut le suffixe +no_cost_orders. Par exemple, `j.appleseed+no_cost_orders@example.com’. La session de paiement qui en résulte vous permet d’appliquer une réduction qui réduit le total de la commande à zéro.

Pour utiliser des commandes à coût zéro avec une grille tarifaire en mode test, définissez la propriété customer-email de la grille tarifaire sur une adresse e-mail dont la partie locale inclut le suffixe +no_cost_orders. Par exemple, `j.appleseed+no_cost_orders@example.com’. La session de paiement qui en résulte vous permet d’appliquer une réduction qui réduit le total de la commande à zéro.

Traitement des 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, 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.