Fonctionnement de Checkout

Cycle de vie de Checkout

1. Lorsque les clients sont prêts à finaliser leur achat, votre application crée une nouvelle Checkout Session.
2. La Checkout Session fournit une URL qui redirige les clients vers une page de paiement hébergée par Stripe.
3. Vos clients saisissent leurs informations de paiement sur la page dédiée et finalisent la transaction.
4. À l’issue de la transaction, un webhook traite la commande à l’aide de l’événement checkout.session.completed.

Intégration avec peu de code

Checkout nécessite un minimum de code et constitue le meilleur choix pour la plupart des intégrations, grâce à ses fonctionnalités préconfigurées et à ses options de personnalisation. Vous pouvez intégrer Checkout en créant une Checkout Session et en collectant les informations de paiement de vos clients. Les paiements sont collectés en redirigeant les clients vers une page de paiement hébergée par Stripe.

Comparez Checkout à d’autres options de paiement Stripe pour déterminer celle qui vous convient le mieux. Checkout permet d’afficher des formulaires de paiement pour collecter les informations de paiement des clients, valider les cartes, gérer les erreurs, etc.

Fonctionnalités

Marquage personnalisé

Vous pouvez configurer les polices, les couleurs, les icônes et les styles de champ de votre page de paiement hébergée par Stripe à l’aide des paramètres de marque dans le Dashboard. Pour plus d’informations, consultez la rubrique Personnaliser votre intégration.

Domaines personnalisés

Si vous utilisez la fonctionnalité de domaine personnalisé de Stripe, vous pouvez servir les pages Checkout hébergées par Stripe sur un sous-domaine de votre domaine personnalisé, cependant cette fonctionnalité est payante. Pour en savoir plus, consultez la section dédiée aux frais et tarifs.

Session Checkout

La Checkout Session est une représentation programmatique de ce que vos clients voient sur la page de paiement. Après avoir créé une Checkout Session, redirigez vos clients vers son URL afin qu’ils finalisent leur achat. Une fois que les clients ont effectué leur achat, vous pouvez traiter leurs commandes en configurant une destination d’événements pour gérer les événements de Checkout Session. Cet extrait de code issu du guide de démarrage rapide vous explique comment créer une Checkout Session dans votre application.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d "line_items[0][price]=
{{PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  --data-urlencode "success_url=https://example.com/success"

Paiements ponctuels et récurrents

Permettez à vos clients d’effectuer des paiements ponctuels ou de souscrire à un produit ou à un service en définissant le paramètre mode dans une Checkout Session.

Panier mixte

Dans Checkout, créez un panier mixte permettant à vos clients d’acheter simultanément des postes d’abonnement et des postes ponctuels. Pour créer un panier mixte, définissez le paramètre mode sur subscription et incluez les ID de tarif (price_data) pour chaque line_item du tableau line_items. Les ID de tarif proviennent d’objets Price créés à l’aide du Dashboard ou de l’API Stripe et vous permettent d’enregistrer des informations sur votre catalogue de produits dans Stripe.

Vous pouvez également utiliser price_data pour référencer les informations d’une base de données externes relatives à vos tarifs et produits, sans pour autant stocker les informations du catalogue de produits sur Stripe. Pour en savoir plus, consultez la page consacrée à la création d’une intégration pour les abonnements.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d "line_items[0][price]={{RECURRING_PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d "line_items[1][price]={{ONE_TIME_PRICE_ID}}" \
  -d "line_items[1][quantity]=1" \
  -d mode=subscription \
  --data-urlencode "success_url=https://example.com/success"

Moyens de paiement

Vous pouvez afficher, activer et désactiver différents moyens de paiement à tout moment dans le Dashboard Stripe. Stripe active certains moyens de paiement par défaut. Nous pourrons également activer d’autres moyens de paiement après vous en avoir informé(e). Consultez notre liste complète des moyens de paiement.

Enregistrer les informations de paiement et les moyens de paiement par défaut

Vous pouvez enregistrer les informations de paiement pour une utilisation ultérieure en transmettant un paramètre d’API lors de la création d’une Checkout Session. Les options disponibles pour l’enregistrement des informations de paiement sont les suivantes :

• Paiement unique : si votre Checkout Session utilise le mode payment, définissez le paramètre payment_intent_data.setup_future_usage.
• Paiement des abonnements : si votre Checkout Session utilise le mode subscription, Stripe enregistre le moyen de paiement par défaut.
• Plusieurs moyens de paiement enregistrés : si un client a enregistré plusieurs moyens de paiement, vous pouvez définir l’un d’eux comme moyen de paiement par défaut en indiquant son ID dans configuration.customer.billing.default_payment_method (objet Account) ou invoice_settings.default_payment_method (objet Customer). Toutefois, ces moyens de paiement ne sont pas proposés lors des achats ultérieurs dans Checkout.

Clients invités

Vous pouvez représenter un client de votre entreprise soit sous forme d’objet Account configuré par le client, soit sous forme d’objet Customer. Ces objets stockent les informations relatives à chaque client et les associent à leurs abonnements et à leurs paiements. Les Checkout Sessions qui n’utilisent pas de clients existants ou n’en créent pas sont associées à des clients invités.

Date d’expiration

Par défaut, une Checkout Session expire au bout de 24 heures.

Vous pouvez définir une durée d’expiration personnalisée pour une Checkout Session en renseignant le paramètre expires_at. Celle-ci peut être comprise entre 30 minutes et 24 heures après la création de la Checkout Session.

Vous pouvez également faire expirer une Checkout Session.

Finaliser une transaction

Pour automatiser les flux de l’entreprise après l’exécution d’une transaction, enregistrez une destination d’événements et créez un gestionnaire d’endpoint de webhook. Envisagez d’activer les événements et automatisations suivants :

• Traiter l’événement checkout.session.completed pour réaliser les commandes lorsqu’un client termine son achat.
• Traitez l’événement checkout.session.expired pour renvoyer les articles dans votre inventaire ou envoyer aux utilisateurs un e-mail d’abandon de panier lorsqu’ils ne valident pas l’achat et que leur panier est sur le point d’expirer.

Gestion des risques

Pour prévenir la fraude, Stripe utilise des modèles d’IA qui analysent les indicateurs disponibles afin de distinguer les paiements frauduleux des paiements légitimes. En activant Radar dans Checkout, Stripe s’appuie sur les données de son réseau pour détecter et bloquer les transactions frauduleuses sur l’ensemble de vos intégrations.

Checkout combine les données de session, le contexte de l’appareil et du navigateur, ainsi que les informations sur le cycle de vie du paiement pour fournir un contexte à Radar et améliorer sa précision. Il propose également des interventions ciblées qui renforcent la sécurité des transactions à risque élevé tout en réduisant les frictions pour les clients de confiance.

Paiement pour les agents

Les pages Stripe Checkout disposent d’une structure et de commandes étiquetées conçues pour aider les clients à finaliser leur paiement, tout en permettant aux agents automatisés de comprendre et de parcourir ces pages. Elles sont également adaptées aux clients ayant des besoins en matière d’accessibilité, tels que ceux qui utilisent des lecteurs d’écran.

Pour prendre en charge les flux de paiement générés par un agent, Stripe fournit également des instructions techniques lorsque celui-ci doit consulter une page Stripe Checkout. Ces instructions peuvent fournir des détails importants tels que la devise, les limites et les étapes suivantes, afin d’aider les agents à finaliser l’achat avec moins de frictions et d’erreurs.