Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous

Intégration complète de la plateforme Connect

Offrir des fonctionnalités Connect à vos comptes connectés par l'intermédiaire de votre propre site Web.

Les composants intégrés Connect vous permettent d’ajouter des fonctionnalités gérées par Stripe à une interface personnalisée que vous fournissez à vos comptes connectés, tels que ceux des plateformes SaaS et des marketplaces. Ils peuvent y effectuer des opérations liées au paiement directement au lieu de passer par le Dashboard de Stripe. Dans le cadre d’une intégration totalement intégrée :

  • Les comptes connectés accèdent aux données, formulaires et notifications liés à Stripe via des composants intégrés à l’application de votre plateforme. Ils n’ont pas accès à un Dashboard Stripe.
  • Stripe gère le risque de crédit et de fraude sur vos comptes connectés. Pour toute action relative au risque ou à la conformité, nous communiquons directement avec les comptes connectés et ils répondent en interagissant avec les composants intégrés.
  • Les notifications par e-mail de Stripe dirigent vos comptes connectés vers les composants intégrés de votre site Web afin qu’ils vérifient leurs informations ou effectuent les actions requises. Vous devez donc fournir à Stripe les URL de ces composants.

Voir le site de démonstration

Nous avons créé un site de démonstration complet pour notre entreprise fictive, Furever. Furever est une plateforme qui fournit aux toiletteurs un logiciel permettant d’encaisser des paiements. Dans cette démo, vous pouvez interagir avec plusieurs composants intégrés, dont l’inscription de compte et la gestion du compte.

Avant de commencer

Avant de pouvoir créer une intégration embarquée, vous devez remplir les conditions préalables suivantes :

  1. Inscrire votre plateforme.
  2. Ajoutez des informations sur l’entreprise pour activer votre compte.
  3. Complétez votre profil de plateforme.
  4. Personnalisez vos paramètres de marque. Connect Onboarding nécessite l’ajout d’un nom d’entreprise, d’une icône et d’une couleur de marque.

Vous devez également décider si votre plateforme sera responsable des tarifs, auquel cas Stripe perçoit les frais de paiement de votre plateforme et vous facturez vos comptes connectés. Dans le cas contraire, Stripe contrôle la tarification et perçoit les frais de paiement directement auprès de vos comptes connectés.

Créer un compte connecté

Dans l’exemple ci-dessous, on crée un compte connecté pour lequel Stripe gère les risques, contrôle les tarifs et assume la responsabilité des exigences liées à l’onboarding. Votre plateforme utilise des composants intégrés et n’est pas responsable des soldes négatifs des comptes connectés. Vos comptes connectés n’ont pas accès aux Dashboards hébergés par Stripe.

Remarque

Parce que Stripe gère les prix dans cet exemple, vous devez intégrer le composant intégré Documents. De plus, Stripe notifie les comptes connectés par e-mail lorsque leurs factures fiscales ou formulaires 1099 sont prêts à être téléchargés. Si vous créez des comptes où votre plateforme contrôle les prix, le composant Documents n’est pas requis, et Stripe n’envoie pas de notifications aux comptes connectés concernant les factures fiscales ou les 1099.

Après l’inscription du compte, vous pouvez demander des fonctionnalités supplémentaires, telles que des moyens de paiement spécifiques.

Appelez /v1/comptes avec les paramètres suivants :

  • country du compte
  • controller.stripe_dashboard.type = none
  • Demander les fonctionnalités card_payments et transfers
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d country=US \
  -d "controller[stripe_dashboard][type]"=none \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true
Example response
{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}"
,
  "object": "account",
  "controller": {
    "type": "application",
    "is_controller": true,
    "losses": {"payments": "stripe"},
    "fees": {"payer": "account"},
    "requirement_collection": "stripe",
    "stripe_dashboard": {
      "type": "none",
    },
  },
  "type": "none",
  ...
}

Configurer les composants intégrés

Les comptes connectés accèdent à leurs comptes et aux fonctionnalités principales de paiement directement via votre plateforme, sans avoir accès au Dashboard hébergé par Stripe. Vous devez donc fournir l’accès à certaines fonctionnalités depuis votre site web.

Votre intégration doit comprendre les composants intégrés suivants :

Votre intégration doit également permettre de répondre aux litiges en fournissant des preuves pour chaque paiement. Cela peut se fairevia notre API ou grâce à un composant intégré (Paiements, informations de paiement, ou litiges pour un paiement).

Nous vous recommandons de prévoir un moyen permettant aux comptes connectés d’ajouter des fonds si nécessaire, afin d’éviter un solde négatif et de prévenir toute interruption d’activité.Vous pouvez le mettre en place en utilisant un composant intégré (Soldes ou Versements).

Vous pouvez également ajouter des composants intégrés supplémentaires ou créer vos propres interfaces utilisateur à l’aide de nos API.

Assurez-vous de configurer des composants intégrés avant l’onboarding des comptes connectés.

Bonnes pratiques

Pour maximiser l’efficacité de votre intégration, envisagez les stratégies suivantes :

  1. Priorité à l’utilisateur : assurez-vous que le processus d’intégration est intuitif en utilisant le composant d’ onboarding des comptes pour guider les utilisateurs lors de la création et de la gestion de leur compte, en décomposant le processus en étapes simples et en fournissant des instructions claires.
  2. Invite pour la conformité : utilisez le composant bannière de notification pour tenir les utilisateurs au courant de leur statut de conformité et des éventuelles exigences en attente. Placez la bannière de manière visible dans votre application, par exemple sur la page d’accueil de votre Dashboard, afin qu’elle soit bien visible et incite à effectuer rapidement les actions nécessaires sur la documentation ou les mises à jour requises.
  3. Conception réactive : assurez-vous que les composants que vous intégrez sont réactifs sur tous les appareils. Étant donné que les comptes connectés peuvent accéder à votre plateforme depuis divers appareils, y compris des téléphones mobiles, assurez-vous que les interfaces d’inscription et de gestion fonctionnent correctement sur différentes tailles d’écran.
  4. Authentification et sécurité des utilisateurs : mettez en place des mesures d’identification renforcées pendant les processus d’onboarding et de gestion des comptes. Bien que l’identification Stripe protège les informations sensibles du compte et la possibilité de modifier les détails du virement, d’autres informations sensibles dépendent uniquement de l’authentification et la sécurité de votre produit. Vous pouvez améliorer la sécurité globale en utilisant des méthodes telles que les codes SMS à usage unique ou l’authentification à deux facteurs.
  5. Mécanismes de retour d’information : intégrez des options de retour d’information au sein de votre flux d’inscription et de vos composants de gestion. Permettez aux utilisateurs de signaler des problèmes ou de suggérer des améliorations, ce qui vous permettra d’améliorer continuellement la plateforme en fonction de leurs retours.
  6. Engagement proactif : encouragez les utilisateurs à maintenir leurs comptes actifs en envoyant des rappels ou des alertes sur les obligations de conformité par e-mail ou via des notifications sur la plateforme. Cette approche proactive peut aider à prévenir les suspensions de compte et à réduire la frustration des utilisateurs.

Inscrire des comptes connectés

Stripe utilise une session de comptes pour indiquer votre intention de donner l’accès au composant intégré au compte connecté. Grâce à une AccountSession, le composant intégré de création de compte collecte toutes les informations requises en fonction des capacités demandées.

Préremplir les informations du compte

Vous pouvez simplifier le processus d’onboarding pour vos comptes connectés en pré-remplissant les propriétés du Account avec les informations déjà connues avant de créer un AccountSession. Le composant d’onboarding ne demande pas les informations déjà présentes sur l’Account. Pré-remplissez autant de données que possible (informations sur l’entreprise, l’individu et le compte externe) en suivant ces étapes :

  1. Utilisez l’outil d’information de vérification requis pour en savoir plus sur les exigences applicables à vos comptes connectés, établies en fonction de leur emplacement, type d’entreprise et fonctionnalités demandées.
  2. Collecter les informations préremplissables correspondant aux exigences.
  3. Fournissez les informations collectées lors de la création du Account ou ajoutez-les avant l’onboarding en mettant à jour le Account.

Après avoir créé un Account et demandé ses fonctionnalités, vous pouvez vérifier ses exigences spécifiques en examinant sa propriété Exigences.

Comme votre plateforme n’est pas responsable des soldes négatifs, votre accès à certaines informations des comptes connectés, comme les comptes de paiement ou les informations sur l’entité juridique, est limité. Une fois qu’un compte connecté a terminé l’onboarding via le composant intégré Account Onboarding, votre plateforme ne peut plus modifier ces propriétés. Les mises à jour doivent être effectuées par le compte connecté lui-même.

Inscrire des utilisateurs via le composant d’inscription intégré

Les comptes connectés doivent s’inscrire et fournir les informations requises pour activer les paiements et les versements. Pour inscrire un compte connecté, intégrez le composant d’inscription intégré sur votre site web et redirigez-y les nouveaux comptes.

Créer une session de compte

Lorsque vous créez une session de compte, activez l’inscription des comptes en spécifiant account_onboarding dans le paramètre components.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[account_onboarding][enabled]"=true

Affichage du composant d’inscription de compte

Après avoir créé la session de compte et initialisé ConnectJS, vous pouvez afficher le composant d’inscription de compte dans le front-end :

account-onboarding.js
JavaScript
React
No results
// Include this element in your HTML
const accountOnboarding = stripeConnectInstance.create('account-onboarding');
accountOnboarding.setOnExit(() => {
  console.log('User exited the onboarding flow');
});
container.appendChild(accountOnboarding);

// Optional: make sure to follow our policy instructions above
// accountOnboarding.setFullTermsOfServiceUrl('{{URL}}')
// accountOnboarding.setRecipientTermsOfServiceUrl('{{URL}}')
// accountOnboarding.setPrivacyPolicyUrl('{{URL}}')
// accountOnboarding.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
//   requirements: {
//     exclude: ['business_profile.product_description']
//   }
// })
// accountOnboarding.setOnStepChange((stepChange) => {
//   console.log(`User entered: ${stepChange.step}`);
// });

Présentez le flux d’onboarding au propriétaire principal du compte. Le propriétaire principal configure l’authentification à Stripe et l’utilisateur peut modifier les informations du compte et réagir en cas de risque. Le compte connecté ne dispose que d’un seul ensemble d’identifiants Stripe. L’utilisateur disposant d’identifiants peut s’authentifier à l’aide de codes temporaires envoyés par SMS pour effectuer des actions plus sensibles, comme mettre à jour les comptes bancaires de destination des virements ou fournir des informations à jour sur l’entité juridique.

Écouter les événements d’onboarding

Au fur et à mesure que le compte connecté progresse dans l’inscription, des événements account.updated sont également envoyés à vos webhooks Connect. Lorsque le compte a terminé de fournir ses informations, la propriété details_submitted de l’Account passe à true. Vérifiez le statut en recherchant details_submitted: true idans le corps de l’événement account.updated dans votre gestionnaire de webhook ou en récupérant le Compte. Si details_submitted est false, affichez à nouveau le composant d’onboarding intégré. Le composant ignore les informations déjà soumises et collecte uniquement les exigences non remplies.

Lorsqu’un compte connecté soumet ses informations et termine le parcours d’intégration, le composant intégré d’onboarding appelle le gestionnaire onExit que vous avez défini lors de l’affichage du composant. Utilisez ce callback pour orienter le compte vers l’action suivante. Si vous ne définissez pas de gestionnaire de sortie, ou n’y effectuez aucune action, le compte voit un message de confirmation sans indication claire de la prochaine étape.

Demander des fonctionnalités supplémentaires (facultatif)

Votre plateforme peut continuer à demander des fonctionnalités supplémentaires après l’intégration d’un compte connecté. Par exemple, vous devez demander les fonctionnalités correspondant à tous les moyens de paiement que vous souhaitez activer pour un compte.

Si l’une des fonctionnalités demandées nécessite des informations supplémentaires, le compte connecté reçoit une notification par le biais de la barre de notification intégrée.

Gérer les mises à jour régulières relatives à la conformité et aux risques

Comme Stripe gère le risque de crédit et de fraude pour vos comptes connectés, vos comptes doivent pouvoir voir et répondre aux alertes de Stripe. Pour cela, votre plateforme doit intégrer la barre de notification et le composant intégré de gestion de compte. Pour en savoir plus sur la manière dont Stripe prend en charge vos comptes connectés via ces composants, consultez l’assistance intégrée Connect.

Intégrer la bannière de notification

Stripe utilise le composant intégré de barre de notification pour informer les comptes connectés des exigences de conformité en attente et d’autres demandes liées aux risques. Répondre à ces notifications permet au compte de rester conforme, afin de pouvoir traiter les paiements et recevoir des fonds. Si aucune notification n’est en attente, le notification banner intégré ne s’affiche pas.

Intégrez la bannière de notification dans un emplacement bien visible et facilement accessible sur votre site web. Par exemple, vous pouvez la placer en haut de votre page de paiements.

Créer une session de compte

Lorsque vous créez une session de compte, activez la bannière de notification en spécifiant notification_banner dans le paramètre components.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[notification_banner][enabled]"=true \
  -d "components[notification_banner][features][external_account_collection]"=true

Afficher le composant de bannière de notification

notification-banner.js
JavaScript
React
No results
// Include this element in your HTML
const notificationBanner = stripeConnectInstance.create('notification-banner');
container.appendChild(notificationBanner);

// Optional:
// notificationBanner.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })

Pour répondre à une bannière de notification, le compte peut cliquer sur un bouton dans la notification. Il n’est pas nécessaire de les rediriger vers le composant intégré de gestion de compte.

Gestion de compte intégrée

Stripe exige le composant intégré de gestion de compte pour la gestion des risques. Intégrez ce composant sur votre site web à l’endroit où un compte met à jour ses paramètres ou son profil.

Créer une session de compte

Lorsque vous créez une session de compte, activez la gestion des comptes en spécifiant account_management dans le paramètre components.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[account_management][enabled]"=true \
  -d "components[account_management][features][external_account_collection]"=true

Afficher le composant de gestion de compte

account-management.js
JavaScript
React
No results
// Include this element in your HTML
const accountManagement = stripeConnectInstance.create('account-management');
container.appendChild(accountManagement);

// Optional:
// accountManagement.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })

Ce composant permet à un compte de mettre à jour ses informations, de répondre aux exigences de conformité et de mettre à jour ses identifiants d’authentification.

Intégration de paiement

Configurez l’intégration de paiement après avoir intégré les composants requis. Vous pouvez ajouter des composants intégrés pour les paiements et les virements à votre plateforme ou créer vos propres flux.

Configurez les webhooks Connect et surveillez l’événement account.updated. Un compte connecté est prêt à recevoir des paiements lorsque sa propriétécharges_enabled est définie sur true.

Inclure des paiements et des virements intégrés

Ajoutez les composants intégrés de paiements et de versements à votre plateforme avant de créer votre intégration de paiements. Ainsi, un compte connecté pourra facilement accéder à ses flux de paiements principaux et les gérer.

Le composant de paiement affiche la liste des paiements du compte connecté et inclut des options de filtrage ainsi que des vues détaillées pour chaque paiement. Un compte peut émettre des remboursements et répondre à des litiges avec des preuves sur des paiements individuels via ce composant. Si vous choisissez de créer et maintenir une liste de paiements entièrement personnalisée et pilotée par API, vous pouvez toujours activer les remboursements et la gestion des litiges en utilisant soit le composant des informations de paiement, le composant de litiges pour un paiement, ou nos API.

Créer une session de compte

Lorsque vous créez une session de compte, activez le composant paiements intégrés en spécifiant les payments dans le paramètre components. Vous pouvez activer ou désactiver une fonctionnalité individuelle du composant paiements en spécifiant le paramètre features sous payments :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[payments][enabled]"=true \
  -d "components[payments][features][refund_management]"=true \
  -d "components[payments][features][dispute_management]"=true \
  -d "components[payments][features][capture_payments]"=true \
  -d "components[payments][features][destination_on_behalf_of_charge_management]"=false

Vos comptes connectés peuvent consulter l’ensemble des informations relatives aux paiements directs. Ils peuvent également gérer les remboursements et les litiges et capturer des paiements si vous activez les fonctions correspondantes lors de la création d’une session de compte.

Afficher le composant de paiement

Après avoir créé la session de compte et initialisé ConnectJS, vous pouvez effectuer le rendu du composant de paiement dans la partie frontale :

payments.js
JavaScript
React
No results
// Include this element in your HTML
const payments = stripeConnectInstance.create('payments');
container.appendChild(payments);

// Optional: specify filters to apply on load
// payments.setDefaultFilters({
//   amount: {greaterThan: 100},
//   date: {before: new Date(2024, 0, 1)},
//   status: ['partially_refunded', 'refund_pending', 'refunded'],
//   paymentMethod: 'card',});

Le composant de virements affiche les virements récents du compte connecté, son solde actuel et la date à laquelle les fonds seront disponibles.

Lors de la création d’une session de compte, activez le composant de virement intégré en spécifiant payouts dans le paramètre components. Vous pouvez activer ou désactiver les fonctionnalités individuelles du composant de virement en spécifiant le paramètre features sous payouts :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[payouts][enabled]"=true \
  -d "components[payouts][features][instant_payouts]"=true \
  -d "components[payouts][features][standard_payouts]"=true \
  -d "components[payouts][features][edit_payout_schedule]"=true \
  -d "components[payouts][features][external_account_collection]"=true

Après avoir créé la session du compte et initialisé ConnectJS, vous pouvez générer le rendu du composant de virement dans le front-end :

payouts.js
JavaScript
React
No results
// Include this element in your HTML
const payouts = stripeConnectInstance.create('payouts');
container.appendChild(payouts);

Pour un guide complet sur l’implémentation des composants intégrés, suivez le guide de démarrage rapide pour l’intégration des composants Connect intégrés.

Accepter un paiement

Si vos comptes connectés effectuent des transactions directement avec les clients, utilisez les paiements directs.

Stripe détermine des frais de transaction pour votre plateforme lorsque controller.fees.payer n’est pas défini sur account pour l’objet Account. En retour, vous êtes responsable de l’imputation des frais de traitement des paiements sur vos comptes connectés. Vous pouvez spécifier une valeur de commission de la plateforme pour chaque paiement de manière à débiter automatiquement vos comptes connectés des frais, sans avoir à développer vous-même cet aspect de votre intégration.

Pour accepter les paiements, nous vous recommandons d’utiliser Stripe Checkout, une page préconfigurée hébergée par Stripe. Checkout prend en charge de nombreux moyens de paiement et affiche automatiquement les plus pertinents pour votre client.

Vous pouvez également utiliser le Payment Element, un composant d’interface utilisateur préconfiguré à intégrer qui vous permet d’accepter des moyens de paiement supplémentaires avec une seule intégration.

Créer une session Checkout Client-side Server-side

Une session Checkout détermine ce qu’un client voit sur la page de paiement hébergée par Stripe, notamment les sous-postes de facture, le montant et la devise de la commande, ainsi que les moyens de paiement acceptés. Dans le cas de paiements directs, Checkout utilise les paramètres de marque du compte connecté. Pour en savoir plus, consultez la section relative à la personnalisation de l’image de marque.

Les comptes connectés ne sont pas responsables des paiements indirects ou des paiements et transferts distincts. En revanche, c’est à eux qu’il revient de gérer les litiges concernant les paiements directs et non à la plateforme.

Pour créer une session Checkout, ajoutez un bouton de paiement qui appelle un endpoint côté serveur sur votre site Web.

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

Sur votre serveur, effectuez l’appel suivant à l’API Stripe. Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d mode=payment \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "payment_intent_data[application_fee_amount]"=123 \
  --data-urlencode success_url="https://example.com/success"
  • line_items : ce paramètre représente les articles achetés par votre client, qui apparaissent dans l’interface utilisateur hébergée.
  • success_url : cet argument permet de rediriger le client une fois le paiement effectué.
  • Stripe-Account : cet en-tête signale un paiement direct pour votre compte connecté. Lors d’un paiement direct, le compte connecté est responsable du paiement des frais Stripe, des remboursements et des contestations de paiement. 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.
  • (Facultatif) payment_intent_data[application_fee_amount] : cet argument spécifie le montant que votre plateforme prévoit de prélever sur la transaction. Une fois le paiement traité sur le compte connecté, le montant application_fee_amount est transféré sur la plateforme et les frais de Stripe sont déduits du solde du compte connecté.

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

Stripe envoie un événement checkout.session.completed une fois le paiement effectué. Utilisez un webhook pour recevoir ces événements et exécuter des actions, comme envoyer une confirmation de commande par e-mail à votre client, enregistrer la vente dans une base de données ou lancer 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.

En plus de gérer l’événement checkout.session.completed, nous vous recommandons de gérer deux autres événements lorsque vous encaissez des paiements avec Checkout :

ÉvénementDescriptionÉtapes suivantes
checkout.session.completedLe client a autorisé le paiement en envoyant le formulaire Checkout.Attendez que le paiement aboutisse ou échoue.
checkout.session.async_payment_succeededLe paiement du client a abouti.Traitez la commande de biens ou de services de votre client.
checkout.session.async_payment_failedLe paiement a été refusé ou a échoué pour une autre raison.Contactez votre 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’état sous-jacent du PaymentIntent passe de processing à succeeded.

Configurer les communications par e-mail avec les comptes connectés

Stripe communique en votre nom avec vos comptes connectés pour gérer les risques et garantir le maintien de la conformité. Vous pouvez personnaliser et marquer ces communications par e-mail avec votre propre domaine de messagerie et votre propre marque de plateforme.

Nous envoyons les e-mails suivants à vos comptes connectés :

  • Les e-mails de compte permettent de vérifier les informations d’un compte telles que les ajouts ou les modifications d’adresses e-mail, de numéro de téléphone ou de compte bancaire.
  • Les e-mails relatifs à la conformité demandent aux comptes de fournir les informations requises. Stripe a souvent besoin de collecter des informations supplémentaires pour maintenir sa conformité vis-à-vis de ses partenaires financiers.
  • Les e-mails relatifs aux risques informent les comptes lorsqu’ils font l’objet d’un examen des risques. Ces e-mails fournissent souvent des instructions sur la manière de soumettre des informations en vue de la résolution d’une action à risque, par exemple pour lever une suspension des virements.
  • Les e-mails fiscaux (uniquement lorsque Stripe perçoit directement des frais Stripe sur les comptes connectés) informent les utilisateurs lorsque leurs factures fiscales, ou formulaires 1099, sont disponibles au téléchargement.

Si vous souhaitez envoyer d’autres e-mails relatifs aux paiements à vos comptes connectés, vous devez les envoyer vous-même. Par exemple, pour envoyer des e-mails concernant de nouveaux litiges, écoutez l’événement charge.dispute.created sur un compte connecté. Lorsque cet événement se produit, utilisez l’API Disputes pour obtenir les détails et les envoyer par e-mail au compte.

Vous devez mettre à jour vos paramètres Connect avec les URL de vos paiements et des workflows de vos comptes connectés afin que les communications par e-mail de Stripe puissent rediriger vos comptes connectés vers ceux-ci. Vous devez définir ces liens avant de créer une AccountSession ou un AccountLink en mode production.

Gérer les redirections des liens des e-mails

Les e-mails envoyés par Stripe qui contiennent un appel à l’action doivent inclure un lien vers cette action. Par exemple, si nous envoyons un e-mail appelant à l’action sur un compte connecté, il doit inclure un lien vers votre composant de gestion de compte.

Avant de pouvoir créer une Account Session en mode production, vous devez fournir les URL sur lesquelles vous avez intégré les composants à votre site Web. Configurez le domaine de l’e-mail d’envoi et les URL des composants intégrés dans la section Liens vers le site des paramètres Connect de votre plateforme.

Remarque

Les environnements de test utilisent les mêmes URL que le mode production.

Pour les composants intégrés à votre site, sélectionnez Oui et entrez l’URL de la page qui héberge le composant. Pour toutes les actions qui ne sont pas gérées par un composant intégré, sélectionnez Non et entrez l’URL de la page de votre site où le compte peut effectuer l’action. Après avoir saisi les URL, testez-les pour vérifier qu’elles ouvrent les bonnes pages.

Vous devez définir des URL pour les éléments suivants :

  • Bannière de notification
  • Gestion de compte
  • Paiements
  • Virements
  • Soldes
  • Documents (lorsque Stripe perçoit des frais Stripe directement à partir des comptes connectés)

Lors de l’envoi d’un e-mail, Stripe ajoute automatiquement l’identifiant du compte connecté à l’URL de redirection en tant que paramètre stripe_account_id. Utilisez ce paramètre pour identifier le compte et vérifier qu’il est authentifié. Configurez l’itinéraire sur votre serveur pour lire les paramètres et afficher le composant intégré approprié.

Pour en savoir plus sur la configuration des e-mails envoyés par Stripe à vos comptes connectés, consultez la documentation sur les communications par e-mail dans les intégrations Connect.

Configurer les paramètres et l’adaptation de vos e-mails à votre marque

Stripe peut envoyer des e-mails reflétant les paramètres de la marque de votre plateforme depuis votre propre domaine de messagerie vers vos comptes connectés. Pour configurer les e-mails de Stripe à vos comptes connectés, accédez à la section E-mails du Dashboard de votre plateforme.

Passer en mode production

À ce stade, vous avez configuré l’intégration de votre plateforme en procédant comme suit :

  • Comptes connectés créés avec la configuration adéquate
  • Composants intégrés permettant aux comptes connectés de s’inscrire, de gérer leur compte et de répondre aux actions liées aux risques par le biais de votre site Web
  • Configurer des paiements à l’aide des paiements directs avec commission de la plateforme
  • Configurez la communication par e-mail de votre marque pour permettre à Stripe de transmettre à vos utilisateurs des informations relatives à la conformité, aux actions à risque et aux documents nécessaires.

Tester votre intégration

Testez votre flux de création de comptes en utilisant l’inscription de compte intégrée à votre plateforme. Testez les paramètres de vos moyens de paiement pour vos comptes connectés en vous connectant à l’un de vos comptes test et en accédant aux paramètres des moyens de paiement. Testez votre tunnel de paiement à l’aide de vos clés de test et d’un compte de test. Vous pouvez utiliser nos cartes de test pour tester votre flux de paiement et simuler divers scénarios.