Comparez les API Checkout Sessions et Payment Intents.
Découvrez les différences entre les API Checkout Sessions et Payment Intents et quand les utiliser avec les Stripe Elements.
Stripe propose deux API de paiement de base que vous pouvez utiliser avec les Elements pour différents niveaux de personnalisation et de contrôle de vos flux de paiement. L’ API Checkout Sessions prend en charge les parcours de paiement courants grâce à des fonctionnalités intégrées qui éliminent la nécessité de recourir à un code personnalisé. Elle est recommandée pour la plupart des développeurs. L’API Payment Intents vous permet d’utiliser un code personnalisé pour un contrôle plus fin du processus de paiement, mais nécessite davantage de code d’intégration et de maintenance.
Remarque
Ce guide est spécifique à l’utilisation des API avec des Elements. Pour explorer d’autres cas d’usage, consultez la section Concevoir une intégration des paiements
Choisissez la bonne API
Il est important de comprendre quelle API convient à votre entreprise afin d’accéder aux fonctionnalités que vous souhaitez et de décider de la quantité de code que vous souhaitez gérer à long terme. Checkout Sessions continuera à prendre en charge de nouvelles fonctionnalités intégrées qui ne seront pas disponibles avec PaymentIntents. Si vous utilisez PaymentIntents, vous pouvez construire manuellement une fonctionnalité similaire dans votre code. Certaines fonctionnalités, telles que Adaptive Pricing, nécessitent un travail de développement plus important lorsqu’elles sont ajoutées manuellement avec Payment Intents.
| Sessions Checkout | Payment Intents | |
|---|---|---|
| Recommandé pour | Entreprises qui souhaitent moins de code d’intégration, moins de maintenance de code au fil du temps et l’accès à des fonctionnalités intégrées qui gèrent l’état du paiement pour vous, telles que les réductions, les postes, la taxe sur les ventes et Adaptive Pricing | Entreprises disposant de leurs propres moteurs de taxation, d’abonnement et de codes promotionnels, et qui ont besoin de la souplesse nécessaire pour créer et gérer leurs sessions de paiement sans fonctionnalités intégrées. |
| Intégration | Utilisez le code pour ajouter une page de paiement et intégrer des produits supplémentaires. Par exemple, activez Stripe Tax en définissant [ automatic_ ] ](/api/checkout/sessions/create#create_checkout_session-automatic_tax-enabled), par rapport à l’API Payment Intents qui vous oblige à appeler manuellement l’API Tax et à lier les calculs. | L’API Payment Intents vous donne un contrôle total pour créer n’importe quelle expérience de paiement. Vous calculez vous-même le montant final avec les taxes, les réductions, les abonnements et la conversion de devises. |
| Interface utilisateur |
| Elements |
| Complexité | Conçu pour se développer avec votre entreprise, qu’il s’agisse de cas d’usage simples ou complexes. | Idéal pour les grandes entreprises dont les cas d’usage avancés et complexes nécessitent des solutions sur mesure. |
Comparaison des fonctionnalités
| Fonctionnalité | API Checkout Sessions | API Payment Intents |
|---|---|---|
| Conception | À utiliser pour des tunnels de paiement complets avec des postes, des taxes et des frais de livraison. | A utiliser pour les cas d’usage complexes qui nécessitent un contrôle granulaire des paiements avec une logique d’entreprise personnalisée. |
| Calcul des taxes | Calcul intégré des taxes avec Stripe Tax. | Nécessite une intégration séparée avec l’API Tax. |
| Abonnements | Création d’abonnements intégrée | Nécessite une intégration séparée avec Subscriptions. |
| Bons de réduction et réductions | Gestion intégrée des bons de réduction et des réductions. | Nécessite de calculer les réductions manuellement. |
| Frais de livraison | Calcul intégré des frais de livraison. | Nécessite le calcul manuel des frais d’expédition. |
| Flexibilité de l’interface utilisateur | Page de paiement hébergée, formulaires intégrés et interface utilisateur personnalisée. | Interface utilisateur Custom uniquement. |
| Collecte d’adresses | Collecte intégrée des adresses client, de facturation et d’expédition. | Nécessite de traiter les adresses manuellement. |
| Suivi des commandes | Fonctionnalité intégrée de récapitulatif de commande et de reçu. | Il est nécessaire de mettre en œuvre un suivi personnalisé des commandes. |
| Mise à jour des montants | Mise à jour dynamique des stocks et des postes. | Nécessite une mise à jour manuelle du montant. |
| Expiration de la session | Expiration automatique après 24 heures. | Pas d’expiration automatique. |
| Événements de webhook | Événements webhook pour le cycle de vie complet du paiement. | Uniquement les événements relatifs à l’état des paiements. |