Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
AperçuAccepter un paiementMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usagePaiements récurrents
Paiements par TPE
Moyens de paiement
Opérations de paiement
Soldes et délai de règlementReçusRemboursements et annulations
Intégrations avancées
Au-delà des paiements

Mettre à jour une intégration Stripe Checkout pour utiliser Managed PaymentsVersion bêta publique

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 in the Dashboard before you can use Managed Payments.

Mettez à jour votre intégration Stripe Checkout existante pour utiliser Managed Payments. Votre intégration doit déjà accepter les paiements en créant des sessions Checkout 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.

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.

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.

Avant de commencer

  • Vous avez une intégration Stripe Checkout existante (soit hébergée, soit sous forme de formulaire intégrable) qui crée des sessions Checkout en mode payment ou subscription.
  • Activez Managed Payments dans votre Dashboard
  • Assurez-vous que vos produits répondent aux conditions d’éligibilité pour Managed Payments. Pour traiter un paiement via Managed Payments, tous les produits achetés par le client doivent être éligibles.
  • Assurez-vous d’utiliser la version de l’API 2025-03-31.basil ou une version ultérieure.

Configurer vos produits pour Managed Payments

Pour le calcul des taxes avec Managed Payments, vos produits doivent avoir un code de taxe défini. Pour consulter les codes de taxe admissibles, consultez la rubrique consacrée au fonctionnement de Managed Payments.

Utilisez le Dashboard ou l’API pour définir un code de taxe pour chacun de vos produits.

Pour modifier le code de taxe d’un produit :

  1. Accédez au Dashboard > Catalogue de produits.
  2. Cliquez sur le menu de débordement () en regard du produit que vous souhaitez modifier.
  3. Cliquez sur Modifier le produit.
  4. Sélectionnez un Code de taxe produit. Les codes de taxes admissibles porteront la mention « Admissible à Managed Payments ».
  5. Cliquez sur Modifier le produit.

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, incluez tax_code dans l’objet product_data. Par exemple, selon que vous acceptez des abonnements ou des paiements uniques :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

Activer Managed Payments lors de la création de votre session Checkout

Mettez à jour l’appel de votre serveur sur l’API Checkout Session pour définir le paramètre managed_payments[enabled] et inclure le paramètre ;managed_payments_preview=v1 dans votre en-tête de version.

Par exemple :

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2026-01-28.clover; managed_payments_preview=v1" \
  -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"

Supprimer les paramètres non pris en charge
Côté serveur

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égorieParamètreMotif
Fiscalitéautomatic_taxManaged Payments s’occupe du calcul et de la collecte des taxes pour vous.
tax_id_collection
subscription_data.default_tax_rates
Moyens de paiementpayment_method_configurationManaged Payments contrôle les moyens de paiement disponibles dans la Checkout Session à l’aide de moyens de paiement dynamiques afin d’afficher les moyens de paiement les plus pertinents pour votre client. Reportez-vous à la section Configurations des moyens de paiement pour savoir comment configurer les paramètres des moyens de paiement pour Managed Payments.
payment_method_options
payment_method_types
Mise à jour du clientcustomer_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 lors de la création de la Session Checkout, l’objet Customer est mis à jour avec toute modification de son nom ou de son adresse de facturation.
customer_update[address]
Livraisonshipping_address_collectionManaged Payments prend uniquement en charge les produits numériques, de sorte que les informations de livraison ne sont jamais collectées.
shipping_options
Connectsubscription_data.application_fee_percentManaged Payments ne prend pas en charge les intégrations Connect.
subscription_data.on_behalf_of
subscription_data.transfer_data
Après-ventesubscription_data.invoice_settingsManaged Payments gère pour vous les actions après-vente, comme la facturation et les e-mails de confirmation.

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, http://localhost:4242/checkout.html depuis Build your checkout).
  2. Cliquez sur le bouton de paiement pour être redirigé(e) vers la page de paiement de Managed Payments.
  3. 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.
  4. 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.

Détails du paiement

  1. Après avoir confirmé le paiement test, accédez au Dashboard > Liste des paiements
  2. 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 qui a été créé
    • Facture 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

Le moyen de paiement associé à l’abonnement est uniquement autorisé à être débité par Managed Payments. Pour l’utiliser pour des transactions ne relevant pas de Managed Payments, vous devez obtenir l’autorisation du client.

Prévisualiser le reçu

  1. Sous Récapitulatif du paiement, cliquez sur Facture.
  2. Cliquez sur Envoyer le reçu pour prévisualiser l’e-mail du reçu envoyé à votre client. Vous pouvez également télécharger le reçu.

Remarque

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 agit en tant que marchand officiel lors du paiement et fournit la gestion des abonnements et la prise en charge des transactions sur Link.com.

Pour tester Link :

  1. Ouvrez votre page de paiement

  2. Cliquez sur le bouton de règlement.

  3. Saisissez la même adresse e-mail que celle que vous avez utilisée pour tester votre page de paiement.

  4. Dans la fenêtre contextuelle, utilisez le code de test 000000 pour vous authentifier.

    Si vous avez coché la case Enregistrer mes informations pour régler plus rapidement lors du premier paiement, la carte de test 4242 est également enregistrée dans votre compte Link.

FacultatifConfigurer le régime de taxe de vos tarifs

Le paramètre 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. 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 and update the Include tax in prices setting.