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.
Note
Pour traiter des commandes à coût zéro à l’aide de l’API Checkout, vérifiez que vous utilisez une version de l’API publiée le 16/08/2023 ou ultérieurement.
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.
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 %.
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.
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.
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 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.
Mise en garde
Lorsque vous activez cette fonctionnalité, vous disposez d’un délai de rétractation de 3 jours pendant lesquels vous pouvez la désactiver. Une fois ce délai écoulé, vous ne pouvez plus la désactiver. Avant de l’activer pour vos liens de paiement réels et vos grilles tarifaires, testez-la avec votre flux de traitement des commandes en mode test.
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.
Erreur fréquente
Pour traiter des commandes à coût zéro, veillez à traiter l’événement checkout.session.completed
, 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.