Créer des paiements directs

Créez des paiements directement sur le compte connecté et prélevez des frais.

Créez des paiements directs lorsque des clients effectuent des transactions directement avec un compte connecté, souvent sans connaître l’existence de votre plateforme. Grâce aux paiements directs :

Le paiement apparaît comme un débit sur le compte connecté, et non sur le compte de votre plateforme.
Le solde du compte connecté augmente à chaque prélèvement.
Le solde de votre compte augmente avec les commissions de la plateforme sur chaque paiement.

Ce type de paiement est le mieux adapté aux plateformes SaaS. Par exemple, Shopify fournit des outils pour créer des vitrines en ligne et Thinkific permet aux enseignants de proposer des cours en ligne.

Remarque

Nous vous recommandons d’utiliser les paiements directs pour les comptes connectés qui ont accès à l’intégralité du Dashboard Stripe.

Web

iOS

Android

React Native

Redirigez vers une page de paiement hébergée par Stripe à l’aide de Stripe Checkout. Comparez cette intégration aux autres types d’intégration de Stripe.

Effort d'intégration

Low-code

Type d'intégration

Redirection vers la page de paiement hébergée par Stripe

Personnalisation de l'interface utilisateur

Personnalisation limitée

Essayer

Tout d’abord, inscrivez-vous pour créer un Compte Stripe.

Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :

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

Une session Checkout contrôle ce que le client voit dans le formulaire de paiement, tel que les postes, le montant de la commande et la devise. Ajoutez à votre site Web un bouton de paiement qui appelle un endpoint côté serveur pour 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 et redirigez votre client vers l’URL renvoyée dans la réponse.

line_items : Cet attribut représente les articles que votre client est en train d’acheter et apparaît sur la page de paiement hébergée par Stripe.
payment_intent_data[application_fee_amount] : cet attribut indique le montant que votre plateforme prélève de la transaction en tant que frais de plateforme. Une fois le paiement traité sur le compte connecté, le montant application_fee_amount est transféré à la plateforme. Pour plus d’informations, consultez la section encaisser des frais.
success_url : Stripe redirige le client vers l’URL de réussite après un paiement réussi et remplace la chaîne {CHECKOUT_SESSION_ID} par l’ID de session Checkout. Vous pouvez l’utiliser pour récupérer la session Checkout et inspecter son état afin de choisir ce que vous voulez montrer au client. Vous pouvez également ajouter vos propres paramètres de requête, qui persistent tout au long du processus de redirection. Consultez la page Personnaliser le comportement de redirection avec une page hébergée par Stripe pour en savoir plus.
Stripe-Account : Cet en-tête indique un paiement direct pour votre compte connecté. Checkout reflète l’image de marque du compte connecté, ce qui donne l’impression aux clients d’être directement en contact avec le compte connecté et non avec 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

Encaisser des commissions

Lorsqu’un paiement est traité, votre plateforme peut prélever une partie de la transaction sous forme de commissions de plateforme. Vous pouvez définir le tarif des commissions de plateforme de deux manières :

Utilisez les outils de tarification de la plateforme pour définir des règles de tarification et les tester. Cette fonctionnalité no-code du Dashboard Stripe n’est actuellement disponible que pour les plateformes responsables du paiement des frais Stripe.
Définissez vos règles de tarification en interne, en spécifiant les commissions de plateforme directement dans un PaymentIntent. Les frais définis avec cette méthode remplacent la logique tarifaire spécifiée dans les outils de tarification de la plateforme.

Votre plateforme peut accepter une commission de plateforme avec les limites suivantes :

La valeur de application_fee_amount doit être positive et inférieure au montant du paiement. La commission de plateforme collectée est plafonnée au montant capturé du paiement.
Aucune commission Stripe supplémentaire n’est appliquée à la commission de la plateforme.
Conformément aux lois et réglementations du Brésil, les plateformes situées en dehors du Brésil comportant des comptes connectés brésiliens ne pourront pas prélever de commission de plateforme par le biais de Stripe.
La devise de application_fee_amount dépend de quelques facteurs de plusieurs devises.

L’opération sur solde du paiement inclut une répartition détaillée des commissions de la plateforme et des frais Stripe. Pour faciliter la génération des rapports, un objet Application Fee est créé après le prélèvement des commissions de la plateforme. Utilisez la propriété amount sur l’objet Application Fee pour créer des rapports. Vous pouvez ensuite accéder à ces objets à partir de l’endpoint Application Fees.

Les commissions de la plateforme reçues sont ajoutées au solde disponible de votre compte à la même fréquence que les fonds issus des paiements Stripe réguliers. Les commissions de la plateforme peuvent être affichées dans la section Frais perçus du Dashboard.

Mise en garde

Par défaut, les commissions de plateforme pour les paiements directs sont créées de façon asynchrone. Si vous développez l’objet application_fee dans une demande de création de paiement, la commission de plateforme est créée de façon synchrone dans le cadre de cette demande. Ne développez l’objet application_fee que si cela est nécessaire, car cela augmente la latence de la demande.

Pour accéder aux objets des commissions de la plateforme pour les commissions créées de façon asynchrone, visualisez l’événement webhook application_fee.created.

Mouvement de fonds avec frais

Lorsque vous indiquez une commission de plateforme pour un paiement, le montant de la commission est transféré vers le compte Stripe de votre plateforme. Lorsque vous traitez un paiement directement depuis le compte connecté, le montant du paiement, moins les frais Stripe et la commission de la plateforme, est versé sur le compte connecté.

Par exemple, si vous effectuez un paiement de 10 USD avec une commission de la plateforme de 1,23 USD (comme dans l’exemple précédent), le montant de cette commission est transféré sur le compte de votre plateforme. Le compte connecté reçoit directement la somme de 8,18 USD (10 USD - 1,23 USD - 0,59 USD, en cas de facturation de frais Stripe standard pour les États-Unis).

Mouvements de fonds pour un paiement avec commission de plateforme

Si vous traitez des paiements dans plusieurs devises, consultez la rubrique sur la manière dont les devises sont traitées dans Connect.

Personnaliser l’image de marque

Votre plateforme et vos comptes connectés peuvent utiliser les paramètres de marque dans le Dashboard pour personnaliser l’image de marque sur la page des paiements. Pour les paiements directs, Chekckout utilise les paramètres de marque du compte connecté.

Vous pouvez également utiliser l’API pour mettre à jour les paramètres de marque :

icon : s’affiche à côté du nom de l’entreprise dans l’en-tête de la page Checkout.
logo : utilisé à la place de l’icône et du nom de l’entreprise dans l’en-tête de la page Checkout.
primary_color : utilisé comme couleur d’arrière-plan sur la page Checkout.
secondary_color : utilisé comme couleur des boutons sur la page Checkout.

Effectuer des remboursements

De la même façon que les plateformes peuvent créer des paiements sur les comptes connectés, elles peuvent également créer des remboursements. Créez un remboursement à l’aide de la clé secrète de votre plateforme en étant identifié avec un compte connecté.

Les commissions de la plateforme ne sont pas automatiquement remboursées lors d’un remboursement. Votre plateforme doit explicitement rembourser la commission de la plateforme, car dans le cas contraire, le compte connecté (le compte sur lequel le paiement a été créé) perd ce montant. Vous pouvez rembourser les commissions de la plateforme en indiquant la valeur true pour refund_application_fee dans la demande de remboursement :

Par défaut, la totalité du paiement est remboursée, mais vous pouvez créer un remboursement partiel en définissant le paramètre amount sur un nombre entier positif. Si le remboursement entraîne le remboursement de la totalité du paiement, la totalité de la commission de plateforme est remboursée. Dans le cas contraire, un montant proportionnel de la commission de la plateforme est remboursé. Vous pouvez également indiquer la valeur false pour refund_application_fee et rembourser la commission de la plateforme séparément.