# L’API Checkout Sessions Créez une intégration de paiement Stripe avec un service de support intégré à l’aide de l’API Checkout Sessions. Utilisez l’[API Checkout Sessions](https://docs.stripe.com/api/checkout/sessions.md) pour créer une intégration de paiement avec prise en charge intégrée du [calcul des taxes](https://docs.stripe.com/payments/checkout/taxes.md), des [réductions](https://docs.stripe.com/payments/checkout/promotions.md), des [abonnements](https://docs.stripe.com/payments/subscriptions.md), de la [livraison](https://docs.stripe.com/payments/during-payment/charge-shipping.md) et de la [conversion de devises](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#exchange-rate). Stripe recommande cette API pour la plupart des intégrations de paiement, car elle gère pour vous les tâches complexes liées au paiement, active des fonctionnalités comme [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) et réduit la quantité de code personnalisé à écrire et à maintenir. L’API Checkout Sessions sert de back-end à plusieurs [interfaces utilisateur de paiement Stripe](https://docs.stripe.com/payments/online-payments.md#payment-uis) : - [Page hébergée par Stripe](https://docs.stripe.com/payments/checkout.md) : redirigez vos clients vers une page de paiement hébergée par Stripe. - [Formulaire intégré](https://docs.stripe.com/checkout/embedded/quickstart.md) : intégrez un formulaire de paiement Stripe directement sur votre site web. - [Tunnel de paiement personnalisé](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) : créez une page de paiement entièrement personnalisée au moyen de [Stripe Elements](https://docs.stripe.com/payments/elements.md), y compris [Payment Element](https://docs.stripe.com/payments/payment-element.md). Pour démarrer, consultez le [guide de démarrage rapide de Checkout Sessions](https://docs.stripe.com/payments/quickstart-checkout-sessions.md). Ce document vous explique les étapes à suivre pour créer une `Checkout Session` sur le serveur, en utilisant son `client_secret` tout en ayant Stripe Elements côté client. ## Une solution de paiement préconfigurée et extensible L’API Checkout Sessions gère pour vous l’intégralité du cycle de vie du processus de paiement. L’utilisation de l’API Checkout Sessions présente notamment les avantages suivants : | Fonctionnalité | Description | | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Fonctionnalités de paiement intégrées | Les fonctionnalités de calcul des taxes, remises, frais de livraison et des abonnements, ainsi [qu’Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) sont disponibles sans aucune intégration d’API supplémentaire. | | Gestion de l’authentification automatique | Stripe gère l’authentification [3D Secure](https://docs.stripe.com/payments/3d-secure.md) ainsi que les autres actions requises du client. | | Interfaces de paiement modulables | Utilisez une page hébergée par Stripe, un formulaire intégré ou les [Stripe Elements](https://docs.stripe.com/payments/elements.md) entièrement personnalisables pour les faire correspondre à votre marque. | | Gestion de l’état du paiement | Stripe assure le suivi de l’état de la session, y compris l’expiration et le statut, de sorte que vous n’ayez pas à vous en soucier. | | Aucun paiement en double | L’API empêche les paiements en double en assurant le suivi du cycle de vie de chaque session. | L’API Checkout Sessions couvre des scénarios de paiement similaires à ceux de [l’API Payment Intents](https://docs.stripe.com/payments/payment-intents.md), tout en sachant cependant qu’elle nécessite une bien moindre quantité de code. Utilisez l’API Payment Intents si vous avez besoin de contrôler chaque aspect du processus de paiement ou si vous prévoyez de créer vous-même la logique de calcul des réductions, des taxes, des abonnements et de la conversion de devises. Pour pouvoir identifier la solution la plus adaptée à votre intégration, [comparez ces deux API](https://docs.stripe.com/payments/checkout-sessions-and-payment-intents-comparison.md). ## Cycle de vie de Checkout L’API Checkout Sessions gère pour vous l’intégralité du cycle de vie du processus de paiement, tout en sachant que ce cycle varie en fonction de [l’interface utilisateur de paiement](https://docs.stripe.com/payments/checkout/how-checkout-works.md) que vous utilisez. ### Sauvegarde des informations dans les métadonnées Stripe prend en charge l’ajout de [métadonnées](https://docs.stripe.com/api.md#metadata) à la plupart des requêtes, y compris aux requêtes adressées à l’API Checkout Sessions. Utilisez les métadonnées pour associer vos propres identifiants, comme des ID de commande, aux sessions Stripe. Les métadonnées sont visibles dans le Dashboard et disponibles dans les rapports pour vous aider à rapprocher les paiements. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d ui_mode=custom \ --data-urlencode "return_url=https://example.com/return" \ -d "metadata[order_id]=6735" ``` Ne sauvegardez pas d’informations sensibles (telles que les informations d’identification personnelles ou les informations de carte bancaire) dans les métadonnées. ## See also - [Mode de fonctionnement de Checkout](https://docs.stripe.com/payments/checkout/how-checkout-works.md) - [Créez une page de paiement avec l’API Checkout Sessions](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) - [Migrer de Payment Intents vers Checkout Sessions.](https://docs.stripe.com/payments/payment-element/migration-ewcs.md)