Commandes à coût zéro
Acceptez les commandes d’articles sans frais ou appliquez 100 % de réduction pour les paiements ponctuels.
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.
Remarque
Pour traiter des commandes à coût zéro à l’aide de l’API Checkout Sessions, vous devez utiliser la version 2023-08-16 ou une version ultérieure de l’API.
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_ pour transmettre un tarif gratuit.
Si le montant total est égal à 0, Checkout ne collecte pas le moyen de paiement du client.
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 %.
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.
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.
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.
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.
Erreur fréquente
Pour traiter des commandes à coût zéro, veillez à traiter l’événement checkout., et non les événements PaymentIntent. Les sessions Checkout terminées à coût zéro n’auront aucun PaymentIntent associé.
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.
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.
Mise en garde
Lorsque vous activez cette fonctionnalité, elle dispose d’une période de grâce de 3 jours pendant laquelle vous pouvez la désactiver. Après 3 jours, vous ne pouvez plus le désactiver. Avant de l’activer pour vos liens de paiement réels et vos grilles tarifaires, testez-le avec votre flux de distribution dans un bac à sable.
Pour utiliser des commandes à coût zéro avec un lien de paiement dans un environnement de test, spécifiez un paramètre d’URL prefilled_ sur une adresse e-mail dont la partie locale inclut le suffixe +no_. Par exemple, j.. 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 dans un environnement de 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_. Par exemple, j.. 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.