Fonctionnement de Checkout

Cycle de vie de Checkout

1. Lorsque votre client est prêt à finaliser ses achats, votre application crée une nouvelle session Checkout.
2. Vous intégrez Checkout sur votre site Web pour afficher un formulaire de paiement.
3. Les clients saisissent leurs informations de paiement et finalisent la transaction.
4. Après la transaction, l’événement webhook checkout.session.completed déclenche le processus de réalisation des commandes.

Intégration avec peu de code

Checkout requiert très peu d’écriture de code et constitue le meilleur choix pour la plupart des intégrations du fait de ses fonctionnalités préconfigurées et de ses options de personnalisation. Vous pouvez intégrer Checkout en créant une session Checkout et en recueillant les informations de paiement du client. Encaissez les paiements en intégrant un formulaire de paiement à votre site Web.

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.

Marquage personnalisé

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

Session Checkout

La session Checkout est une représentation programmatique de ce que vos clients voient sur le formulaire de paiement. Après avoir créé une session Checkout, montez Checkout sur votre page de paiement pour effectuer l’achat. Lorsque les clients finalisent leur achat, vous pouvez traiter leurs commandes en configurant des destinations d’événements de façon à traiter les événements de la session Checkout. L’extrait de code du guide de démarrage rapide donne un exemple de création d’une session Checkout dans votre application.

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 mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Paiements ponctuels et récurrents

Offrez à vos clients la possibilité d’effectuer des paiements ponctuels ou de s’abonner à un produit ou service en définissant le paramètre mode dans une session Checkout.

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

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 des informations de paiement pour une utilisation ultérieure en envoyant un paramètre API lorsque vous créez une session. Voici quelques options d’enregistrement des informations de paiement :

• Paiement unique : si votre session Checkout utilise le mode payment, définissez le paramètre payment_intent_data.setup_future_usage.
• Paiement des abonnements : si votre session Checkout 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 enregistrer un moyen de paiement par défaut dans le champ default_payment_method de l’objet Customer. Cependant, ces moyens de paiement n’apparaissent pas pour les retours dans Checkout.

Clients invités

L’objet Customer représente un client de votre entreprise. Il permet de suivre les abonnements et les paiements émanant d’une même personne. Les sessions Checkout sans objet Customer sont associées à des clients invités.

Finaliser une transaction

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

• Traitez l’événement checkout.session.completed pour traiter les commandes lorsqu’un client finalise 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