# Configurer des articles facultatifs Offrez à vos clients la possibilité d’acheter des produits complémentaires au moment du paiement à l’aide d’articles facultatifs. # Page hébergée complète > This is a Page hébergée complète for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/optional-items?payment-ui=stripe-hosted. ![](https://docs.stripecdn.com/84b8dfc6dd8a1b5c8d1375a930b8c2d38f48d151fb004cbdd88f048e25a79ff5.mp4) La configuration des articles facultatifs sur une *session Checkout* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription) permet aux clients d’ajouter plusieurs produits facultatifs à leur commande au moment du paiement. Cela peut augmenter la valeur moyenne de vos commandes et votre chiffre d’affaires. Par exemple, si vous vendez un service d’abonnement, vous pouvez également proposer à vos clients des modules complémentaires facultatifs au moment du paiement, tels que des frais d’installation uniques et un plan d’assistance prioritaire récurrent. ## Créer une session Checkout avec des articles facultatifs Lors de la création d’une session Checkout, vous configurez `optional_items` de la même manière que `line_items`, en spécifiant un `price` et une `quantity` pour chaque article facultatif que vous souhaitez proposer au client. Vous pouvez proposer jusqu’à 10 articles facultatifs au cours d’une même session Checkout. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "optional_items[0][price]={{PRICE_ID}}" \ -d "optional_items[0][quantity]=1" \ -d "optional_items[1][price]={{PRICE_ID}}" \ -d "optional_items[1][quantity]=1" ``` ## Permettre aux clients d’ajuster la quantité Vous pouvez également permettre à vos clients d’ajuster la quantité d’articles facultatifs après les avoir ajoutés à leur commande en spécifiant `adjustable_quantity`, comme vous le faites pour les postes. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "optional_items[0][price]={{PRICE_ID}}" \ -d "optional_items[0][quantity]=1" \ -d "optional_items[0][adjustable_quantity][enabled]=true" \ -d "optional_items[0][adjustable_quantity][minimum]=0" \ -d "optional_items[0][adjustable_quantity][maximum]=10" ``` Les clients peuvent toujours supprimer les articles facultatifs de leur commande, même si vous spécifiez une `quantity` ou un `adjustable_quantity.minimum` supérieurs à 0. ## Limitations - Prend en charge au maximum 10 articles facultatifs. - Ne prend pas en charge les articles facultatifs récurrents pour lesquels une vente incitative d’abonnement est configurée pour un poste. - Ne prend pas en charge les articles facultatifs utilisant des montants personnalisés, ni l’utilisation d’articles facultatifs lorsqu’un poste utilise des montants personnalisés. - Non pris en charge en mode `setup`. - Les articles facultatifs récurrents en mode `payment` ne sont pas pris en charge. - L’intervalle de facturation (mensuel, annuel, etc.) de tous les articles facultatifs récurrents doit correspondre à l’intervalle des postes récurrents. - Les [ventes croisées](https://docs.stripe.com/payments/checkout/cross-sells.md) configurées dans le catalogue de produits n’apparaîtront pas dans les sessions Checkout créées avec des articles facultatifs. ### Ajout d’un article facultatif associé au produit Utilisez les [ventes croisées](https://docs.stripe.com/payments/checkout/cross-sells.md) pour spécifier les produits complémentaires que vous souhaitez toujours recommander en tant qu’articles facultatifs lors du paiement. Lorsque vous configurez une vente croisée associée à un produit, l’élément facultatif apparaît sur toutes les sessions Checkout admissibles avec ce produit. Les ventes croisées n’apparaissent pas si vous spécifiez des éléments facultatifs supplémentaires sur un lien de paiement. Pour configurer une vente croisée : 1. Sur la page [Catalogue de produits](https://dashboard.stripe.com/test/products), sélectionnez votre produit. 1. Sur la page d’information du produit, sous **Ventes croisées**, recherchez le produit pour lequel vous souhaitez effectuer des ventes croisées. Une fois que vous avez configuré une vente croisée, les sessions Checkout qui contiennent le produit que vous avez sélectionné l’ajoutent automatiquement en tant qu’article facultatif. ![](https://docs.stripecdn.com/73a4baa89ea5ac0e30a39cd03f33b21e35979759cdc9293b680695226a5b7dbe.mp4) # Page intégrée complète > This is a Page intégrée complète for when payment-ui is embedded-page. View the full page at https://docs.stripe.com/payments/checkout/optional-items?payment-ui=embedded-page. ![](https://docs.stripecdn.com/84b8dfc6dd8a1b5c8d1375a930b8c2d38f48d151fb004cbdd88f048e25a79ff5.mp4) La configuration des articles facultatifs sur une *session Checkout* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription) permet aux clients d’ajouter plusieurs produits facultatifs à leur commande au moment du paiement. Cela peut augmenter la valeur moyenne de vos commandes et votre chiffre d’affaires. Par exemple, si vous vendez un service d’abonnement, vous pouvez également proposer à vos clients des modules complémentaires facultatifs au moment du paiement, tels que des frais d’installation uniques et un plan d’assistance prioritaire récurrent. ## Créer une session Checkout avec des articles facultatifs Lors de la création d’une session Checkout, vous configurez `optional_items` de la même manière que `line_items`, en spécifiant un `price` et une `quantity` pour chaque article facultatif que vous souhaitez proposer au client. Vous pouvez proposer jusqu’à 10 articles facultatifs au cours d’une même session Checkout. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "optional_items[0][price]={{PRICE_ID}}" \ -d "optional_items[0][quantity]=1" \ -d "optional_items[1][price]={{PRICE_ID}}" \ -d "optional_items[1][quantity]=1" ``` ## Permettre aux clients d’ajuster la quantité Vous pouvez également permettre à vos clients d’ajuster la quantité d’articles facultatifs après les avoir ajoutés à leur commande en spécifiant `adjustable_quantity`, comme vous le faites pour les postes. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "optional_items[0][price]={{PRICE_ID}}" \ -d "optional_items[0][quantity]=1" \ -d "optional_items[0][adjustable_quantity][enabled]=true" \ -d "optional_items[0][adjustable_quantity][minimum]=0" \ -d "optional_items[0][adjustable_quantity][maximum]=10" ``` Les clients peuvent toujours supprimer les articles facultatifs de leur commande, même si vous spécifiez une `quantity` ou un `adjustable_quantity.minimum` supérieurs à 0. ## Limitations - Prend en charge au maximum 10 articles facultatifs. - Ne prend pas en charge les articles facultatifs récurrents pour lesquels une vente incitative d’abonnement est configurée pour un poste. - Ne prend pas en charge les articles facultatifs utilisant des montants personnalisés, ni l’utilisation d’articles facultatifs lorsqu’un poste utilise des montants personnalisés. - Non pris en charge en mode `setup`. - Les articles facultatifs récurrents en mode `payment` ne sont pas pris en charge. - L’intervalle de facturation (mensuel, annuel, etc.) de tous les articles facultatifs récurrents doit correspondre à l’intervalle des postes récurrents. - Les [ventes croisées](https://docs.stripe.com/payments/checkout/cross-sells.md) configurées dans le catalogue de produits n’apparaîtront pas dans les sessions Checkout créées avec des articles facultatifs. ### Ajout d’un article facultatif associé au produit Utilisez les [ventes croisées](https://docs.stripe.com/payments/checkout/cross-sells.md) pour spécifier les produits complémentaires que vous souhaitez toujours recommander en tant qu’articles facultatifs lors du paiement. Lorsque vous configurez une vente croisée associée à un produit, l’élément facultatif apparaît sur toutes les sessions Checkout admissibles avec ce produit. Les ventes croisées n’apparaissent pas si vous spécifiez des éléments facultatifs supplémentaires sur un lien de paiement. Pour configurer une vente croisée : 1. Sur la page [Catalogue de produits](https://dashboard.stripe.com/test/products), sélectionnez votre produit. 1. Sur la page d’information du produit, sous **Ventes croisées**, recherchez le produit pour lequel vous souhaitez effectuer des ventes croisées. Une fois que vous avez configuré une vente croisée, les sessions Checkout qui contiennent le produit que vous avez sélectionné l’ajoutent automatiquement en tant qu’article facultatif. ![](https://docs.stripecdn.com/73a4baa89ea5ac0e30a39cd03f33b21e35979759cdc9293b680695226a5b7dbe.mp4)