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.
A Checkout Session controls what your customer sees in the payment form such as line items, the order amount, and currency. Add a checkout button to your website that calls a server-side endpoint to create a Checkout Session.
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. Voir
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.
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 :
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é, l’ sous-jacent passe de étatprocessing à succeeded ou à un état d’échec.
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.
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.
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 la plateforme prélevée est plafonnée au montant 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 du 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 lors d’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 vous devez absolument le faire, 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).
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.
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.
Welcome to the Stripe Shell!
Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your
Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe
resources in test mode.
- View supported Stripe commands:
- Find webhook events:
- Listen for webhook events:
- Call Stripe APIs: stripe [api resource] [operation] (e.g., )
Le shell Stripe est plus optimisé sur la version bureau.