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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_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 \
  --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 dispose de plusieurs moyens de paiement enregistrés, vous pouvez définir un moyen de paiement par défaut dans le champ default_payment_method de l’objet Customer. Toutefois, ces moyens de paiement ne s’affichent pas lors des achats ultérieurs dans Checkout.

Clients invités

L’objet Customer représente un client de votre entreprise. Il stocke ses informations et l’associe à ses abonnements et à ses paiements. Les Checkout Sessions qui n’utilisent pas de Customers existants ou n’en créent pas de nouveaux sont associées à des clients invités à la place.

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.