# Mettre à jour une intégration Stripe Checkout pour utiliser Managed Payments Découvrez comment mettre à jour votre intégration Stripe existante pour utiliser Managed Payments. > #### Conditions d'utilisation du service requises > > You must accept the [Managed Payments terms of service](https://stripe.com/legal/managed-payments) in the [Dashboard](https://dashboard.stripe.com/settings/managed-payments) before you can use Managed Payments. Mettez à jour votre intégration [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) existante pour utiliser Managed Payments. Votre intégration doit déjà accepter les paiements en créant des *sessions 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) en mode `payment` ou `subscription`. Si vous ne disposez pas d’une intégration Checkout, consultez plutôt la page consacrée à la [configuration de Managed Payments](https://docs.stripe.com/payments/managed-payments/set-up.md). ### Raisons de mettre à jour Une intégration Managed Payments permet à Stripe d’assumer pour vous la responsabilité de la conformité aux taxes indirectes, de la prévention de la fraude, de l’assistance aux transactions clients et de la gestion des commandes. Pour en savoir plus, consultez la page [Fonctionnement des paiements gérés](https://docs.stripe.com/payments/managed-payments/how-it-works.md). ### Abonnements existants Durant cette version bêta, vous pouvez uniquement activer les Managed Payments pour les nouveaux abonnements achetés via une Checkout Session sur Managed Payments. Les abonnements existants ne sont pas admissibles. ## Before you begin - Vous avez une intégration Stripe Checkout existante (soit [hébergée](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=stripe-hosted), soit sous forme de [formulaire intégrable](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=embedded-form)) qui crée des sessions Checkout en mode `payment` ou `subscription`. - Activez Managed Payments dans votre [Dashboard](https://dashboard.stripe.com/settings/managed-payments) - Assurez-vous que vos produits répondent aux [critères d’éligibilité](https://docs.stripe.com/payments/managed-payments/eligibility.md) pour Managed Payments. Pour traiter un paiement via Managed Payments, tous les produits achetés par le client doivent être éligibles. - Utilisez une [version bêta de l’API](https://docs.stripe.com/sdks/versioning.md#public-preview-release-channel) de `2025-04-30.version bêta` ou ultérieure pour la création de Checkout Session. ## Configurer vos produits pour Managed Payments Pour calculer les taxes, Managed Payments exige que vos *produits* (Products represent what your business sells—whether that's a good or a service) aient un *code fiscal* (A tax code is the category of your product for tax purposes) défini. Consultez les [codes fiscaux éligibles](https://docs.stripe.com/payments/managed-payments/eligibility.md#eligible-tax-codes). Utilisez le Dashboard ou l’API pour définir un code de taxe pour chacun de vos produits. #### Dashboard Pour modifier le code de taxe d’un produit : 1. Accédez au **Dashboard** > [Catalogue de produits](https://dashboard.stripe.com/products). 1. Cliquez sur le menu de débordement (⋯) en regard du produit que vous souhaitez modifier. 1. Cliquez sur **Modifier le produit**. 1. Sélectionnez un **Code de taxe produit**. Les codes de taxes admissibles porteront la mention « **Admissible** à Managed Payments ». 1. Cliquez sur **Modifier le produit**. #### API Pour modifier le code de taxe d’un produit : ```curl curl https://api.stripe.com/v1/products/{{PRODUCT_ID}} \ -u "<>:" \ -d tax_code={{TAX_CODE}} ``` Répétez cette opération pour chaque produit que vous souhaitez utiliser avec Managed Payments. Si vous créez vos produits en ligne lors de la création de votre [session Checkout](https://docs.stripe.com/api/checkout/sessions/create.md), incluez `tax_code` dans l’objet `product_data`. Par exemple, selon que vous acceptez des abonnements ou des paiements uniques : #### Abonnements ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][product_data][name]=Basic subscription" \ -d "line_items[0][price_data][product_data][tax_code]={{TAX_CODE}}" \ -d "line_items[0][price_data][recurring][interval]=month" \ -d "line_items[0][quantity]=1" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" ``` #### Paiements ponctuels ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][product_data][name]=1000 tokens" \ -d "line_items[0][price_data][product_data][tax_code]={{TAX_CODE}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Activer Managed Payments lors de la création de votre session Checkout Mettez à jour l’appel de votre serveur à [l’API Checkout Session](https://docs.stripe.com/api/checkout/sessions/create.md) pour définir le paramètre `managed_payments[enabled]` et utiliser une [version bêta de l’API](https://docs.stripe.com/sdks/versioning.md#public-preview-release-channel). Par exemple : #### Abonnements ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "managed_payments[enabled]=true" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" ``` #### Paiements ponctuels ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "managed_payments[enabled]=true" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Supprimer les paramètres non pris en charge [Côté serveur] #### Abonnements Pour agir en tant que marchand officiel, Stripe contrôle certaines parties de la session de paiement. Par conséquent, certains paramètres ne sont pas disponibles lorsque vous utilisez Managed Payments, et vous devez les supprimer lorsque vous créez des Sessions Checkout Managed Payments. | Catégorie | Paramètre | Motif | | ------------------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Adaptive Pricing | `adaptive_pricing` | Adaptive Pricing est toujours activé sur Managed Payments. | | Fiscalité | `automatic_tax` | Managed Payments s’occupe du calcul et de la collecte des taxes pour vous. | | `tax_id_collection` | | `subscription_data.default_tax_rates` | | Moyens de paiement | `payment_method_configuration` | Managed Payments contrôle les moyens de paiement disponibles dans la Checkout Session à l’aide de [moyens de paiement dynamiques](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) afin d’afficher les moyens de paiement les plus pertinents pour votre client. Reportez-vous à la section [Configurations des moyens de paiement](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments) pour savoir comment configurer les paramètres des moyens de paiement pour Managed Payments. | | `payment_method_options` | | `payment_method_types` | | Mise à jour du client | `customer_update[name]` | Managed Payments exige que votre client ait un nom et une adresse de facturation valides afin de calculer la taxe de vente. Si vous fournissez l’ID d’un [client existant](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer) lors de la création de la Session Checkout, l’objet [Customer](https://docs.stripe.com/api/customers/object.md) est mis à jour avec toute modification de son nom ou de son adresse de facturation. | | `customer_update[address]` | | Livraison | `shipping_address_collection` | Managed Payments prend uniquement en charge les produits numériques, de sorte que les informations de livraison ne sont jamais collectées. | | `shipping_options` | | Connect | `subscription_data.application_fee_percent` | Managed Payments ne prend pas en charge les intégrations Connect. | | `subscription_data.on_behalf_of` | | `subscription_data.transfer_data` | | Après-vente | `subscription_data.invoice_settings` | Managed Payments gère pour vous les actions après-vente, telles que la facturation et les e-mails de confirmation. | | `invoice_creation` | #### Paiements ponctuels Pour agir en tant que *merchant of record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account), Stripe contrôle certaines parties de la session de paiement. Par conséquent, certains paramètres ne sont pas disponibles lorsque vous utilisez Managed Payments, et vous devez les supprimer lorsque vous créez des Sessions Checkout Managed Payments. | Catégorie | Paramètre | Motif | | ------------------------------------------------------------ | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Fiscalité | `automatic_tax` | Managed Payments s’occupe du calcul et de la collecte des taxes pour vous. | | `tax_id_collection` | | Moyens de paiement | `excluded_payment_method_types` | Managed Payments contrôle les moyens de paiement disponibles dans la Checkout Session à l’aide de [moyens de paiement dynamiques](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) afin d’afficher les moyens de paiement les plus pertinents pour votre client. Reportez-vous à la section [Configurations des moyens de paiement](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments) pour savoir comment configurer les paramètres des moyens de paiement pour Managed Payments. | | `adaptive_pricing` | | `payment_intent_data.setup_future_usage` | | `payment_method_configuration` | | `payment_method_options.{payment_method}.setup_future_usage` | | `payment_method_types` | | Mise à jour du client | `customer_update[name]` | Managed Payments exige que votre client ait un nom et une adresse de facturation valides afin de calculer la taxe de vente. Si vous fournissez l’ID d’un [client existant](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer) lors de la création de la Session Checkout, l’objet [Customer](https://docs.stripe.com/api/customers/object.md) est mis à jour avec toute modification de son nom ou de son adresse de facturation. | | `customer_update[address]` | | Livraison | `shipping_address_collection` | Managed Payments prend uniquement en charge les produits numériques, de sorte que les informations de livraison ne sont jamais collectées. | | `shipping_options` | | `payment_intent_data.shipping` | | Connect | `payment_intent_data.application_fee_amount` | Managed Payments ne prend pas en charge les intégrations Connect. | | `payment_intent_data.on_behalf_of` | | `payment_intent_data.transfer_data` | | `payment_intent_data.transfer_group` | | Après-vente | `invoice_creation` | Managed Payments gère pour vous les actions après-vente, comme la facturation et les e-mails de confirmation. | | `payment_intent_data.statement_descriptor` | | `payment_intent_data.statement_descriptor_suffix` | | `payment_intent_data.receipt_email` | ## Tests Testez si votre intégration fonctionne correctement pour vos clients. ### Checkout 1. Démarrez votre serveur et accédez à votre page de paiement (par exemple, depuis [Build your checkout](https://docs.stripe.com/payments/managed-payments/set-up.md#build-your-checkout)). 1. Cliquez sur le bouton de paiement pour être redirigé(e) vers la page de paiement de Managed Payments. 1. Sur la page de paiement, saisissez différentes adresses de facturation pour voir comment Managed Payments calcule les taxes pour les clients de différents pays ou territoires. 1. Pour traiter le paiement, saisissez votre adresse e-mail, votre numéro de téléphone et le numéro de carte de test `4242 4242 4242 4242` avec n’importe quel CVC et n’importe quelle date d’expiration future. Pour en savoir plus, consultez la section [Tests](https://docs.stripe.com/testing.md). ### Détails du paiement #### Item 1 1. Après avoir confirmé le paiement test, accédez au **Dashboard** > [Transactions](https://dashboard.stripe.com/test/payments) 1. Cliquez sur votre paiement test pour afficher les détails du paiement. Cette page affiche les éléments suivants : - Produit qui a été acheté - [Abonnement](https://docs.stripe.com/api/subscriptions.md) qui a été créé - [Facture](https://docs.stripe.com/api/invoices.md) qui a été créée - Montant des taxes calculées et collectées avec Managed Payments - Libellé de relevé bancaire qui s’affiche sur les relevés de vos clients > #### Autorisation du client > > Lorsqu’un client achète un abonnement via Managed Payments, il autorise uniquement son moyen de paiement à être débité par Managed Payments. Assurez-vous d’obtenir le consentement approprié de votre client pour débiter ce moyen de paiement pour toute transaction en dehors de Managed Payments. #### Item 2 1. Après avoir confirmé le paiement test, accédez au **Dashboard** > [Transactions](https://dashboard.stripe.com/test/payments) 1. Cliquez sur votre paiement test pour afficher les détails du paiement. Cette page affiche les éléments suivants : - Produit qui a été acheté - [Abonnement](https://docs.stripe.com/api/subscriptions.md) créé (si acheté) - [Facture](https://docs.stripe.com/api/invoices.md) qui a été créée - Montant des taxes calculées et collectées avec Managed Payments - Libellé de relevé bancaire qui s’affiche sur les relevés de vos clients #### Prévisualiser le reçu 1. Sous **Historique des reçus**, cliquez sur **Afficher le reçu**. 1. Cliquez sur **Envoyer reçu** pour avoir un aperçu du reçu envoyé par e-mail à votre client. > En environnement de test, vous ne recevrez pas automatiquement les e-mails de reçu après l’achat mais pourrez les envoyer manuellement en suivant les instructions ci-dessus. ### Link [Link](https://docs.stripe.com/payments/link.md) agit en tant que marchand officiel lors du paiement et propose la gestion des abonnements ainsi qu’un support pour les transactions sur le site [Link](https://link.com). Vous pouvez tester le fonctionnement de Link au moment du paiement en créant un compte Link lors d’une Checkout Session initiale. Après avoir créé le compte Link, tentez une autre session en utilisant la même adresse e-mail. Pour vous identifier, utilisez le code d’accès de test `000000`. Les achats de test n’apparaîtront pas dans l’application Link. Vous pouvez tester les outils de gestion des commande dans l’application Link en créant un compte Link pendant une Checkout Session en mode production. ## Optional: Configurer le régime de taxe de vos tarifs Le paramètre [tax_behavior](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#tax-behavior) indique si la taxe doit être ajoutée à un tarif HT (`tax_behavior: exclusive`) ou si elle est déjà incluse dans un tarif TTC (`tax_behavior: inclusive`). Managed Payments utilise le [comportement fiscal spécifié sur votre tarif](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#set-tax-behavior-on-price). Si vous ne spécifiez pas le comportement fiscal du tarif, Managed Payments ajoute par défaut les taxes en plus du tarif que vous avez défini. To change the default, go to the **Dashboard** > [Tax settings](https://dashboard.stripe.com/settings/tax) and update the **Include tax in prices** setting.