Permettez aux marchands de votre plateforme d’accepter des paiements directementVersion bêta publique

Facilitez les paiements aux entreprises effectués directement par leurs clients sur votre plateforme Saas.

Permettez à votre compte connecté configuré par le marchand d’accepter des paiements directs via une page Checkout hébergée par Stripe, qui reflète son image de marque.

Créer une session Checkout
Côté client
Côté serveur

Ajoutez à votre site Web un bouton de paiement qui appelle un endpoint côté serveur afin de créer une session Checkout.

checkout.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Sur votre serveur,créez une Session Checkout qui affiche le formulaire de paiement à votre client, y compris les détails d’achat, tels que les postes, le montant de la commande et la devise. Redirigez votre client vers l’URL renvoyée dans la réponse.

Paramètres	Description
`line_items`	Affiche jusqu’à 100 éléments achetés sur la page de paiement hébergée par Stripe.
`payment_intent_data[application_fee_amount]`	Spécifie le montant que votre plateforme déduit de la transaction à titre de commission de la plateforme. Ce montant est transférés sur le solde de votre plateforme après l’exécution du paiement. Consultez la section percevoir des frais pour plus d’informations.
`success_url`	L’endroit où Stripe redirige le client après l’exécution du paiement. Stripe met à jour l’URL avec le`{CHECKOUT_SESSION_ID}` généré à partir de cette requête. Vous pouvezpersonnaliser le comportement de redirection avec une page hébergée par Stripe pour : Récupérez la Session Checkout et vérifiez son état afin de déterminer ce que vous devez afficher à votre client. Ajoutez vos propres paramètres de requête, qui persistent tout au long du processus de redirection.
`Compte Stripe`	En-tête qui identifie votre compte connecté comme le marchand officiel de la transaction. Checkout utilise l’image de marque du compte connecté plutôt que celle de votre plateforme.

Les paiements que vous créez directement sur le compte connecté sont indiqués uniquement sur ce compte. Ces paiements n’apparaissent pas dans le Dashboard ou dans les exportations de votre plateforme. Pour les comptes connectés que votre plateforme contrôle, les paiements directs sont inclus dans les rapports et dans Sigma. Vous pouvez toujours récupérer ces informations en utilisant l’API Stripe.

Gérer les événements post-paiement
Côté serveur

Stripe envoie un événement checkout.session.completed à l’issue du paiement. Utilisez un webhook pour recevoir ces événements et exécuter des actions en conséquence, comme l’envoi d’un e-mail de confirmation de commande à votre client, l’enregistrement de la vente dans une base de données ou le lancement d’un flux de livraison.

Nous vous conseillons d’écouter ces événements plutôt que d’attendre un rappel du client. Côté client, il arrive en effet que l’utilisateur ferme la fenêtre de son navigateur ou quitte l’application avant l’exécution du rappel. Avec certains moyens de paiement, la confirmation du paiement peut par ailleurs prendre entre 2 et 14 jours. Configurer votre intégration de manière à ce qu’elle écoute les événements asynchrones vous permettra d’accepter plusieurs moyens de paiement avec une seule intégration.

Stripe recommande de gérer tous les événements suivants lors de la collecte de paiements avec Checkout :

Événement	Description	Étapes suivantes
checkout.session.completed	Le client a autorisé le paiement en envoyant le formulaire Checkout.	Attendez que le paiement aboutisse ou échoue.
checkout.session.async_payment_succeeded	Le paiement du client a abouti.	Traitez la commande de biens ou de services de votre client.
checkout.session.async_payment_failed	Le paiement a été refusé ou a échoué pour une autre raison.	Contactez le client par e-mail et demandez-lui de passer une nouvelle commande.

Ces événements incluent tous l’objet Checkout Session. Une fois le paiement effectué, le PaymentIntent passe de état sous-jacent processing à succeeded ou à un état d’échec.

Tester l'intégration

Numéro de carte	Scénario	Méthode de test
	Le paiement par carte bancaire aboutit et ne nécessite pas d’authentification.	Remplissez le formulaire de paiement par carte bancaire en saisissant le numéro de carte ainsi que la date d’expiration, le CVC et le code postal de votre choix.
	Le paiement par carte bancaire requiert une authentification.	Remplissez le formulaire de paiement par carte bancaire en saisissant le numéro de carte ainsi que la date d’expiration, le CVC et le code postal de votre choix.
	La carte est refusée avec un code de refus de type `insufficient_funds`.	Remplissez le formulaire de paiement par carte bancaire en saisissant le numéro de carte ainsi que la date d’expiration, le CVC et le code postal de votre choix.
	La carte UnionPay a un numéro d’une longueur variable, allant de 13 à 19 chiffres.	Remplissez le formulaire de paiement par carte bancaire en saisissant le numéro de carte ainsi que la date d’expiration, le CVC et le code postal de votre choix.

Consultez la section consacrée aux tests pour obtenir des informations supplémentaires sur la manière de tester votre intégration.

FacultatifActiver d'autres moyens de paiement

Naviguez vers la page Gérer les moyens de paiement pour vos comptes connectés dans le Dashboard pour configurer les moyens de paiement acceptés par vos comptes connectés. Les modifications apportées aux paramètres par défaut s’appliqueront à tous les comptes connectés, nouveaux et existants.

Consultez les ressources suivantes pour obtenir des informations sur les moyens de paiement :

Un guide des moyens de paiement pour vous aider à choisir les moyens de paiement adaptés à votre plateforme.
Fonctionnalités du compte pour vérifier que les moyens de paiement que vous avez choisis sont compatibles avec vos comptes connectés.
Les tableaux des moyens de paiement pris en charge par produit pour vérifier que les moyens de paiement que vous avez choisis sont compatibles avec vos produits et tunnels de paiement Stripe.

Pour chaque moyen de paiement, vous pouvez sélectionner l’une des options suivantes de la liste déroulante :

Activé par défaut	Vos comptes connectés acceptent ce moyen de paiement lors du paiement. Si certains moyens de paiement peuvent uniquement être désactivés ou bloqués, cela signifie que vos comptes connectés qui ont accès au Dashboard doivent les activer depuis leur page des paramètres.
Désactivé par défaut	Vos comptes connectés n’acceptent pas ce moyen de paiement lors du paiement. Si vous autorisez vos comptes connectés avec accès au Dashboard Stripe à gérer leurs propres moyens de paiement, ils ont la possibilité de l’activer.
Bloqué	Vos comptes connectés n’acceptent pas ce moyen de paiement lors du paiement. Si vous autorisez vos comptes connectés avec accès au Dashboard Stripe à gérer leurs propres moyens de paiement, ils n’ont pas la possibilité de l’activer.

Options de liste déroulante pour les moyens de paiement, chacune affichant une option disponible (Bloqué, Activé par défaut, Désactivé par défaut)

Options des moyens de paiement

Si vous apportez une modification à un moyen de paiement, vous devez cliquer sur Vérifier les modifications dans la barre en bas de l’écran, puis sur Enregistrer et appliquer pour mettre à jour vos comptes connectés.

Boîte de dialogue qui s'affiche après avoir cliqué sur le bouton Enregistrer, avec une liste des modifications apportées par l'utilisateur

Boîte de dialogue d’enregistrement

Autoriser vos comptes connectés à gérer leurs moyens de paiement

Stripe recommande d’autoriser vos comptes connectés à personnaliser leurs propres moyens de paiement. Cette option permet à chaque compte connecté ayant accès au Dashboard Stripe d’afficher et de mettre à jour leur page de Moyens de paiement. Seuls les propriétaires des comptes connectés peuvent personnaliser leurs moyens de paiement. Le Dashboard Stripe affiche l’ensemble des moyens de paiement par défaut que vous avez appliqués à tous les comptes connectés, nouveaux comme existants. Vos comptes connectés peuvent remplacer ces valeurs par défaut, à l’exception des moyens de paiement que vous avez bloqués.

Cochez la case Personnalisation de compte pour activer cette option. Vous devez cliquer sur Vérifier les modifications dans la barre en bas de l’écran, puis sélectionner Enregistrer et appliquer pour mettre à jour ce paramètre.

Capture d'écran de la case à cocher pour permettre aux propriétaires connectés de personnaliser leurs moyens de paiement

Case à cocher Personnalisation de compte

Fonctionnalités liées aux moyens de paiement

Pour permettre à vos comptes connectés d’accepter des moyens de paiement supplémentaires, vous devez vous assurer qu’ils disposent de fonctionnalités actives pour chaque moyen de paiement. La plupart des moyens de paiement ont les mêmes exigences de vérification que la fonctionnalité card_payments, avec quelques restrictions et exceptions. Le tableau des fonctionnalités des modes de paiement répertorie les moyens de paiement qui nécessitent une vérification supplémentaire par rapport aux cartes.

Accédez aux paramètres de paiement du compte connecté dans le Dashboard pour demander des fonctionnalités sur vos comptes connectés nouveaux et existants pour chaque combinaison de moyen de paiement et de pays.

Étapes suivantes

Si votre stratégie de monétisation prévoit de débiter des frais par transaction, apprenez à collecter les commissions de la plateforme de chaque paiement.
Si vous prévoyez de facturer des frais d’abonnement pour l’utilisation de votre plateforme, apprenez à utiliser la facturation pour débiter des frais de service.