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

Configurer Managed PaymentsVersion bêta publique

Découvrez comment accepter un paiement à l’aide de 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.

Utilisez Managed Payments pour accepter des paiements mondiaux pour des produits numériques. Managed Payments permet à Stripe d’agir en tant que marchand officiel en votre nom. Pour en savoir plus, consultez la section Fonctionnement des paiements gérés.

Avant de commencer

Créer des produits et tarifs

Vous pouvez accepter des abonnements et des paiements uniques :

Stripe utilise des produits pour représenter les différents biens ou services que vous vendez. Par exemple, si vous avez plusieurs niveaux d’abonnement, tels que Basique et Premium, créez un produit distinct pour chaque niveau.

Les tarifs représentent le montant que vous facturez à votre client pour un produit, et la fréquence à laquelle vous le facturez. Un produit peut avoir plusieurs tarifs. Par exemple, votre abonnement basique peut avoir deux tarifs : 10 USD par mois et 100 USD par an. Vous pouvez également définir différentes devises pour chaque tarif, par exemple 10 USD par mois et 15 CAD par mois.

Utilisez le Dashboard ou l’API pour créer des produits et des tarifs pour chacun des produits que vous commercialisez :

Créer un nouveau produit et un nouveau tarif

Pour créer un nouveau produit et lui attribuer un tarif :

  1. Accédez au Dashboard > Catalogue de produits.
  2. Cliquez sur Créer un produit.
  3. Saisissez le nom du produit, sa description et sélectionnez un code de taxe produit.
    • Le code de taxe sélectionné doit être admissible à Managed Payments. Les codes de taxes admissibles porteront la mention « Admissible à Managed Payments ».
  4. Pour le tarif, saisissez le Montant et la Devise.
  5. Définissez la période de facturation en fonction de la fréquence à laquelle vous souhaitez facturer votre client pour cet abonnement.
  6. Utilisez le volet d’aperçu à droite pour voir combien de taxe les clients paieront en fonction de leur pays ou territoire.
  7. Cliquez sur Ajouter un produit.
  8. Répétez ces étapes pour chaque produit que vous commercialisez.

Ajouter un tarif à un produit existant

Pour ajouter un autre tarif à un produit existant :

  1. Ouvrez le catalogue de produits.
  2. Cliquez sur le produit auquel vous souhaitez ajouter un tarif.
  3. Cliquez sur le bouton + dans la section Tarifs.
  4. Configurez le tarif comme décrit ci-dessus.
  5. Cliquez sur Créer un tarif.

Créer votre interface d'encaissement
Côté client

Stripe Checkout vous permet d’accepter les paiements de vos clients via une page de paiement hébergée par Stripe. Vous êtes responsable de la redirection de votre client vers la page de paiement, et Stripe redirige votre client vers votre site une fois le paiement effectué. Pour en savoir plus, consultez la page consacrée au fonctionnement de Checkout.

Pour créer votre page de paiement, vous devez ajouter un bouton de paiement et une page de confirmation de paiement à votre site.

Ajouter un bouton de paiement

Ajoutez à votre site web un bouton de paiement qui appelle un endpoint sur votre serveur. Par exemple :

checkout.html
<html>
  <head>
    <title>Subscribe to our cool new service</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Subscribe</button>
    </form>
  </body>
</html>

Lorsque votre client clique sur ce bouton, il est redirigé vers la page de paiement hébergée par Stripe.

Ajouter une page de réussite du paiement

Créez ensuite une page de confirmation de paiement pour que votre client puisse la consulter après avoir finalisé sa commande. Hébergez cette page de confirmation de paiement sur votre site. Par exemple :

success.html
<html>
  <head><title>Thanks for subscribing!</title></head>
  <body>
    <h1>Thanks for subscribing!</h1>
    <p>
      We appreciate your business!
      If you have any questions, please email us at
      <a href="mailto:orders@example.com">orders@example.com</a>.
    </p>
  </body>
</html>

Stripe redirige votre client vers cette page une fois qu’il a effectué un paiement autorisé.

Ajouter une page d’annulation (facultatif)

Vous pouvez également créer une page d’annulation pour que votre client puisse voir s’il met fin au processus de paiement. Par exemple :

cancel.html
<html>
  <head>
    <title>Checkout canceled</title>
  </head>
  <body>
    <p>Not ready to subscribe yet? No problem, we'll be here when you are!</p>
  </body>
</html>

Stripe redirige votre client vers cette page s’il clique sur le bouton Retour de la page de paiement.

Configurer votre serveur
Côté serveur

Stripe utilise Checkout Sessions pour représenter ce que votre client voit lorsqu’il est redirigé vers le formulaire de paiement. Vous pouvez configurer les sessions Checkout avec des options telles que les postes de facture à débiter ou les devises à accepter.

Créer une session Checkout

Créez une session Checkout en utilisant l’un des tarifs que vous avez créés comme poste. Définissez le mode sur subscription, et définissez la success_url sur l’URL de vos pages de réussite. Pour activer Managed Payments, définissez managed_payments[enabled] sur true et incluez ;managed_payments_preview=v1 dans votre en-tête de version.

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://localhost:4242/success"

Créer un endpoint

Ajoutez un endpoint à votre serveur qui crée une session Checkout. Le chemin d’accès à l’endpoint doit correspondre à l’attribut action de votre bouton de paiement.

Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse.

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# This example sets up an endpoint using the Sinatra framework.

require 'json'
require 'sinatra'
require 'stripe'

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

Stripe.api_version = '2026-01-28.clover; managed_payments_preview=v1;'

post '/create-checkout-session' do
  session = Stripe::Checkout::Session.create({
    line_items: [{
      price: '{{PRICE_ID}}',
      quantity: 1
    }],
    mode: 'subscription',
    managed_payments: {enabled: true},
    success_url: 'http://localhost:4242/success'
  })

  redirect session.url, 303
end

Tester votre endpoint

Confirmez que votre point d’accès est accessible en démarrant votre serveur Web (par exemple, localhost:4242) et en exécutant la commande suivante :

Command Line
curl -X POST -is "http://localhost:4242/create-checkout-session" -d ""

La réponse ressemble à ceci dans votre terminal :

Command Line
HTTP/1.1 303 See Other
Location: https://checkout.stripe.com/c/pay/cs_test_...
...

Gérer les événements post-paiement

Stripe envoie un événement checkout.session.completed lorsqu’un client effectue un paiement par session Checkout. Utilisez l’outil de webhook du Dashboard ou suivez le guide consacré aux webhooks pour recevoir et gérer ces événements.

Écoutez ces événements au lieu d’attendre que Stripe redirige votre client vers votre page de confirmation de paiement. Évitez d’utiliser votre page de confirmation de paiement uniquement pour déclencher des actions post-paiement.

Configurez votre intégration pour écouter les événements asynchrones afin de gérer correctement les différents types de moyens de paiement susceptibles d’être retardés. Pour en savoir plus, consultez la page consacrée au traitement des commandes Checkout.

Gérez les événements suivants lors de l’encaissement de paiements avec Checkout :

ÉvénementDescription
checkout.session.completedEnvoyé lorsqu’un client termine une session Checkout.
checkout.session.async_payment_succeededEnvoyé lorsqu’un paiement effectué avec un moyen de paiement différé (par exemple, un prélèvement automatique ACH) aboutit.
checkout.session.async_payment_failedEnvoyé lorsqu’un paiement effectué avec un moyen de paiement différé (par exemple, un prélèvement automatique ACH) échoue.

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.

Voir aussi