Accéder directement au contenu
Créez un compte
 ou
connectez-vous
Le logo de la documentation Stripe
/
Créer un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
AperçuTrouver votre cas d'usageManaged Payments
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements en personne
Au-delà des paiements

Guide de migration de Checkout

Découvrez comment migrer vers les dernières intégrations Stripe.

L’ancienne version de Checkout présentait aux clients une boîte de dialogue modale qui recueillait les informations de la carte et renvoyait un jeton ou une source à votre site Web. En revanche, Payment Links et la version actuelle de Checkout sont des pages de paiement intelligentes hébergées par Stripe qui créent des paiements ou des abonnements. Les deux intégrations prennent en charge Apple Pay, Google Pay, Dynamic 3D Secure dynamique, Connect, la réutilisation d’objets Customers existants, et de nombreuses autres fonctionnalités. Vous pouvez également comparer d’autres intégrations de paiement si Payment Links ou Checkout ne correspondent pas à votre cas d’usage.

Avant de commencer

Si vous utilisez les trousses SDK de Stripe, mettez-les à niveau vers la version la plus récente.

Choisissez votre modèle économique

Pour effectuer la migration à partir de l’ancienne version de Checkout, suivez le guide correspondant le mieux à votre modèle économique. Chaque guide recommande un chemin d’intégration avec des exemples de code.

En suivant le guide de migration correspondant, vous pouvez également vous référer à la table de conversion pour effectuer le mappage de paramètres spécifiques et d’options de configuration.

Catalogue de produits et tarifications dynamiques

Si vous vendez des produits pour lesquels le montant ou les postes sont déterminés de manière dynamique (par exemple avec un vaste catalogue de produits ou pour des dons), consultez Accepter les paiements ponctuels.

Vous avez peut-être utilisé l’ancienne version de Checkout pour créer un jeton ou une source côté client, que vous avez ensuite transmis à votre serveur pour créer un paiement. La version actuelle de Checkout inverse ce flux. Vous créez d’abord une session sur votre serveur, redirigez votre client vers Checkout. Ce dernier est ensuite de nouveau redirigé vers votre application après avoir effectué le paiement.

Avant

Avec l’ancienne version de Checkout, vous affichiez le montant et la description dynamiques et collectiez les informations de carte auprès de votre client.

client.html
<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Custom t-shirt"
    data-description="Your custom designed t-shirt"
    data-amount="{{ORDER_AMOUNT}}"
    data-currency="usd">
  </script>
</form>

Ensuite, vous transmettiez le jeton ou la source qui en résultait à votre serveur pour le paiement.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="Custom t-shirt" \
  -d "amount"="{{ORDER_AMOUNT}}" \
  -d "currency"="usd"

Après

Ajoutez à votre site Web un bouton de paiement qui fait appel à un point de terminaison côté serveur afin de créer une session Checkout.

checkout.html
<html>
  <head>
    <title>Buy cool new product</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">Checkout</button>
    </form>
  </body>
</html>

Une session Checkout est la représentation à l’aide d’un programme de ce que votre client voit lorsqu’il est redirigé vers le formulaire de paiement. Vous pouvez la configurer à l’aide de différentes options, par exemple ce qui suit :

Incluez un objet success_url avec l’URL d’une page sur votre site Web vers laquelle votre client est redirigé après avoir effectué le paiement.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"="Custom t-shirt" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse. Si vous devez traiter la commande de biens après le paiement, consultez Traiter des paiements Checkout et Payment Link.

Abonnements dynamiques

Si vous fournissez des services d’abonnement qui sont déterminés de manière dynamique ou qui exigent la prise en charge d’autres fonctionnalités avancées, consultez le guide Configurer un abonnement.

Vous avez peut-être utilisé l’ancienne version de Checkout pour créer un jeton ou une source côté client, que vous avez ensuite transmis à votre serveur pour créer un client ou un abonnement. La version actuelle de Checkout inverse ce flux. Vous créez d’abord une session sur votre serveur, redirigez votre client vers Checkout. Ce dernier est ensuite de nouveau redirigé vers votre application en cas de succès.

Avant

Avec l’ancienne version de Checkout, vous affichiez les informations sur l’abonnement et collectiez les informations de carte auprès de votre client.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Gold Tier"
    data-description="Monthly subscription with 30 days trial"
    data-amount="2000"
    data-label="Subscribe">
  </script>
</form>

Ensuite, vous transmettiez le jeton ou la source qui en résultait à votre serveur pour créer un client et un abonnement.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/subscriptions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{PRICE_ID}" \
  -d "trial_period_days"=30

Après

Ajoutez à votre site Web un bouton de paiement qui fait appel à un point de terminaison côté serveur afin de créer une session Checkout.

checkout.html
<html>
  <head>
    <title>Subscribe to 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>

Une session Checkout est la représentation à l’aide d’un programme de ce que votre client voit lorsqu’il est redirigé vers le formulaire de paiement. Vous pouvez la configurer à l’aide de différentes options, par exemple ce qui suit :

Incluez un objet success_url avec l’URL d’une page sur votre site Web vers laquelle votre client est redirigé après avoir effectué le paiement.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=30 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success"

Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse. Le client est redirigé vers success_url une fois que le client et l’abonnement sont créés. Si vous devez traiter la commande de services achetés après le paiement, consultez Traiter des paiements Checkout et Payment Link.

Plateformes et places de marché Connect

Si vous exploitez une plateforme ou une place de marché Connect et que vous créez des paiements impliquant des comptes connectés, envisagez d’utiliser la version actuelle de Checkout.

L’exemple suivant montre comment utiliser l’API Checkout Sessions pour traiter un paiement direct. Vous pouvez également utiliser Checkout et Connect avec les paiements indirects et les paiements et transferts distincts.

Avant

Avec l’ancienne version de Checkout, vous collectiez les informations de carte auprès de votre client, côté client.

client.html
<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Food Marketplace"
    data-description="10 cucumbers from Roger's Farm"
    data-amount="2000">
  </script>
</form>

Ensuite, vous transmettiez le jeton ou la source qui en résultait à votre serveur pour le paiement au nom du compte connecté.

Command Line
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source"="{{TOKEN_ID}}" \
  -d "description"="10 cucumbers from Roger\"s Farm" \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "application_fee_amount"=200 \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}"

Après

Ajoutez à votre site Web un bouton de paiement qui fait appel à un point de terminaison côté serveur afin de créer une session Checkout.

checkout.html
<html>
  <head>
    <title>Roger's Farm</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">Checkout</button>
    </form>
  </body>
</html>

Une session Checkout est la représentation à l’aide d’un programme de ce que votre client voit lorsqu’il est redirigé vers le formulaire de paiement. Vous pouvez la configurer à l’aide de différentes options, par exemple ce qui suit :

Incluez un objet success_url avec l’URL d’une page sur votre site Web vers laquelle votre client est redirigé après avoir effectué le paiement.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price_data][currency]"=usd \
  --data-urlencode "line_items[0][price_data][product_data][name]"="Cucumbers from Roger's Farm" \
  -d "line_items[0][price_data][unit_amount]"=200 \
  -d "line_items[0][quantity]"=10 \
  -d "payment_intent_data[application_fee_amount]"=200 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse. Si vous devez traiter la commande de biens ou de services après le paiement, consultez Traiter des paiements Checkout et Payment Link.

Enregistrement de moyens de paiement pour utilisation ultérieure

Si vous fournissez à vos clients des services que vous ne facturez pas immédiatement, consultez le guide Configurer des paiements ultérieurs.

Vous avez peut-être utilisé l’ancienne version de Checkout pour créer un jeton ou une source côté client, que vous avez ensuite transmis à votre serveur à des fins d’utilisation ultérieure. La version actuelle de Checkout inverse ce flux. Vous créez d’abord une session sur votre serveur, redirigez votre client vers Checkout. Ce dernier est ensuite de nouveau redirigé vers votre application en cas de succès.

Avant

Avec l’ancienne version de Checkout, vous affichiez les informations sur le paiement et collectiez les informations de carte auprès de votre client.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Cleaning Service"
    data-description="Charged after your home is spotless"
    data-amount="2000">
  </script>
</form>

Ensuite, vous transmettiez la source ou le jeton généré à votre serveur pour créer un éventuel paiement.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="Cleaning service" \
  -d "amount"="{{ORDER_AMOUNT}}" \
  -d "currency"="usd"

Après

Ajoutez à votre site Web un bouton de paiement qui fait appel à un point de terminaison côté serveur afin de créer une session Checkout.

checkout.html
<html>
  <head>
    <title>Cleaning 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>

Une session Checkout est la représentation à l’aide d’un programme de ce que votre client voit lorsqu’il est redirigé vers le formulaire de paiement. Vous pouvez la configurer à l’aide de différentes options, par exemple ce qui suit :

Incluez un objet success_url avec l’URL d’une page sur votre site Web vers laquelle votre client est redirigé après avoir terminé la configuration du paiement.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=setup \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}"

Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse pour recueillir les informations sur le moyen de paiement. Le client est redirigé vers le success_url une fois qu’il a terminé le flux. Lorsque vous êtes prêt(e) à encaisser un paiement, récupérez le SetupIntent dans la session Checkout et utilisez-le pour préparer la transaction.

Catalogue de produits simple avec tarification fixe

Si vous vendez des produits dont les prix sont fixes (tels que des t-shirts ou des livres numériques), consultez le guide sur les liens de paiement. Vous avez peut-être utilisé l’ancienne version de Checkout pour créer un jeton ou une source côté client, que vous avez ensuite transmis à votre serveur pour créer un paiement.

Avant

Avec l’ancienne version de Checkout, vous affichiez le montant et la description et collectiez les informations de carte auprès de votre client.

client.html
<form action="/pay" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="T-shirt"
    data-description="Comfortable cotton t-shirt"
    data-amount="500"
    data-currency="usd">
  </script>
</form>

Ensuite, vous transmettiez la source ou le jeton généré à votre serveur pour créer un client et un paiement.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="{{STRIPE_EMAIL}}" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="T-shirt" \
  -d "amount"=500 \
  -d "currency"="usd"

Après

Créez un produit et un prix qui représente le poste (de facture). L’exemple suivant crée le produit en ligne. Vous pouvez également créer ces objets dans le Dashboard.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=500 \
  -d "product_data[name]"=T-shirt

Créez un lien de paiement dans le Dashboard à l’aide du produit et du prix. Après avoir créé le lien, cliquez sur le bouton Acheter pour configurer la conception et générer le code que vous pourrez copier et coller dans votre site Web.

index.html
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
'{{BUY_BUTTON_ID}}'

    publishable-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

  >
  </stripe-buy-button>
</body>

Abonnements simples

Si vous fournissez un service d’abonnement simple (tel qu’un accès mensuel au logiciel), consultez le guide sur les liens de paiement. Vous avez peut-être utilisé l’ancienne version de Checkout pour créer un jeton ou une source côté client, que vous avez ensuite transmis à votre serveur pour créer un client et un abonnement.

Avant

Avec l’ancienne version de Checkout, vous affichiez les informations sur l’abonnement et collectiez les informations de carte auprès de votre client.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Gold Tier"
    data-description="Monthly subscription"
    data-amount="2000"
    data-currency="usd"
    data-label="Subscribe">
  </script>
</form>

Ensuite, vous transmettiez le jeton ou la source qui en résultait à votre serveur pour créer un client et un abonnement.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="{{STRIPE_EMAIL}}" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/subscriptions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "items[][price]"="{PRICE_ID}" \
  -d "items[][quantity]"=1

Après

Créez un produit et un prix qui représente l’abonnement. L’exemple suivant crée le produit en ligne. Vous pouvez également créer ces objets dans le Dashboard.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=2000 \
  -d "recurring[interval]"=month \
  -d "product_data[name]"="Gold Tier"

Créez un lien de paiement dans le Dashboard à l’aide du produit et du prix. Après avoir créé le lien, cliquez sur le bouton Acheter pour configurer la conception et générer le code que vous pourrez copier et coller dans votre site Web.

index.html
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
'{{BUY_BUTTON_ID}}'

    publishable-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

  >
  </stripe-buy-button>
</body>

Conversion des paramètres

La version actuelle de Checkout prend en charge la plupart des fonctionnalités de l’ancienne version de Checkout. Cependant, ils ne partagent pas la même API. Le tableau suivant fournit une correspondance des paramètres et des options de configuration entre l’ancienne version et la version actuelle. Pour obtenir une liste complète des options de configuration, consultez Sessions Checkout.

Ancienne versionVersion actuelleConseils pour l’intégration
allowRememberMeNon prise en chargeRéutilisez les clients existants en précisant le paramètre customer lors de la création d’une session Checkout. Vous pouvez également activer Link pour permettre à vos clients d’enregistrer et de réutiliser leurs informations de paiement en toute sécurité.
amountCalculé automatiquement comme la somme des montants sur tous les line_itemsLe montant total est la somme des postes que vous passez dans Checkout.
billingAddressSession.billing_address_collectionCheckout recueille automatiquement l’adresse de facturation lorsqu’elle est requise à des fins de prévention de la fraude ou de réglementation. Configurez ce paramètre sur required pour recueillir systématiquement l’adresse de facturation.
closedcancel_urlLorsqu’un client veut fermer Checkout, il doit soit fermer l’onglet du navigateur, soit déplacer son curseur sur cancel_url.
currencySession.currency
descriptionSession.line_items.description ou product.descriptionSi vous indiquez un prix, Checkout génère automatiquement une description pour la fréquence des paiements. Si vous définissez le paramètre Session.line_items, Checkout affiche le nom de chaque poste dans le paramètrename.
emailSession.customer_emailSi vous connaissez déjà l’adresse courriel de votre client, vous pouvez la faire remplir automatiquement avec customer_email lors de la création de la session Checkout.

image

Marque de l’entreprise Téléversez le logo ou l’icône de votre entreprise dans le Dashboard.

Images de produit : Précisez les images pour chaque poste avec product.images.

Checkout utilise des images spécifiques pour la marque de votre entreprise et pour les produits que vous vendez. Checkout affiche le logo de votre entreprise par défaut et revient à l’icône de votre entreprise à côté du nom de votre entreprise.

keyCe n’est plus un paramètre passé dans Checkout
localeSession.localeVous pouvez spécifier un paramètre régional pris en charge lors de la création d’une session Checkout.
nameproduct.name pour les prix précisés dans Session.line_itemsSi vous indiquez un prix, Checkout affiche le nom du produit associé à ce prix. Si vous définissez le paramètre Session.line_items, Checkout affiche le name de chaque poste.
panelLabelsubmit_typeCheckout personnalise automatiquement le texte du bouton en fonction des articles que vous vendez. Pour les paiements ponctuels, utilisez submit_type pour personnaliser le texte du bouton.
shippingAddresssession.shipping_address_collectionCollectez les informations relatives à l’adresse de livraison en transmettant un tableau contenant les pays autorisés allowed_countries vers lesquels vous souhaitez faire des livraisons.
token ou sourcesuccess_urlIl n’y a plus de rappel en JavaScript lorsque le paiement est terminé. Comme votre client paie dans une page différente, définissez l’objet success_url pour rediriger votre client après qu’il a effectué le paiement.
zipCodeAutomatiquement recueilli par CheckoutCheckout recueille automatiquement le code postal lorsqu’il est requis à des fins de prévention de la fraude ou de réglementation.

Voir aussi

Cette page vous a-t-elle été utile?
OuiNon
Besoin d'aide? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications.
Des questions? Contactez l'équipe commerciale.
GML? Lire llms.txt.
Optimisé par Markdoc