Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Outils de développement
Aperçu
Démarrer avec Connect
Principes de base de l'intégration
Exemples d'intégration
Inscrire des comptes
Configurer les dashboards des comptes
    Démarrer avec les composants intégrés Connect
    Personnaliser les composants intégrés Connect
    Composants intégrés Connect pris en charge
      Composants disponibles
      Gestion de compte
      Inscription des comptes
      Soldes
      Litiges sur un paiement
      Liste des litiges
      Documents
      Compte financier
      Transactions du compte financier
      Carte Issuing
      Liste des cartes Issuing
      Bannière de notification
      Détails du paiement
      Paiements
      Virements
      Liste des virements
      Immatriculations fiscales
      Paramètres fiscaux
      Composants en version bêta
      Installation de l'application
      Fenêtre d'affichage de l'application
      Financement Capital
      Demande de financement Capital
      Promotion du financement Capital
      Exporter les transactions fiscales
      Paramètres des moyens de paiement
      Graphique de suivi
    Personnalisation du Dashboard Stripe
    Contrôles de la plateforme pour les comptes du Dashboard Stripe
    Dashboard Express
Accepter des paiements
Effectuer des virements vers des comptes
Gérer votre plateforme Connect
Formulaires fiscaux pour votre plateforme Connect
Utiliser les types de comptes connectés
AccueilPlateformes et places de marchéConfigure account DashboardsSupported Connect embedded components

Inscription des comptes

Utilisez le composant intégré Connect pour l’inscription des comptes

Copier la page

Le composant d’inscription de compte utilise l’API Accounts pour lire les exigences et générer un formulaire d’inscription, localisé pour chaque pays pris en charge par Stripe et qui valide les données. L’intégration intégrée prend également en charge tous les types d’entreprises, diverses configurations de représentants d’entreprise, le chargement de documents, la vérification d’identité et les états de vérification.

Pour en savoir plus, consultez la page Inscription intégrée.

Options de collecte des exigences

Avec l’inscription intégrée, vous pouvez contrôler la collecte des exigences currently_due ou eventually_due, ainsi que l’inclusion d’exigences futures. Vous pouvez personnaliser ce comportement en utilisant l’attribut collectionOptions lors de l’intégration du composant d’inscription de compte.

Collecte de comptes externes

Utilisez la fonctionnalité external_account_collection pour contrôler si le composant collecte ou non des informations sur les comptes externes. Ce paramètre est activé par défaut, et seules les plateformes chargées de collecter les informations à jour lorsque les exigences sont insatisfaites ou évoluent (y compris les comptes Custom) peuvent le désactiver. Lorsqu’external_account_collection est activé, l’authentification de l’utilisateur est requise. Vous pouvez désactiver l’authentification de l’utilisateur de Stripe avec le paramètre disable_stripe_user_authentication.

Désactiver l’authentification utilisateur Stripe

Utilisez la fonctionnalité disable_stripe_user_authentication pour contrôler si le composant nécessite une authentification utilisateur Stripe. La valeur par défaut est l’opposé de la valeur external_account_collection. Par exemple, si vous ne définissez pas external_account_collection, sa valeur est définie sur « true » par défaut, et disable_stripe_user_authentication est défini par défaut sur « false ». Cette valeur ne peut être « true » que pour les comptes pour lesquels controller.requirement_collection est application.

Nous vous recommandons de mettre en œuvre l’authentification à deux facteurs ou des mesures de sécurité équivalentes à titre de bonne pratique. Pour les configurations de compte qui prennent en charge cette fonctionnalité, comme les comptes Custom, vous assumez la responsabilité des comptes connectés s’ils ne sont pas en mesure de rembourser les soldes négatifs.

Personnaliser les politiques présentées à vos utilisateurs

Les comptes connectés voient le Contrat d’utilisation du service et la Politique de confidentialité lors de l’inscription intégrée. Les utilisateurs de comptes connectés qui n’ont pas accepté le Contrat d’utilisation du service Stripe doivent l’accepter sur le dernier écran de l’inscription. L’inscription intégrée dispose également d’un pied de page avec des liens vers le Contrat d’utilisation du service et la Politique de confidentialité de Stripe.

Dans le cas des comptes connectés pour lesquels la plateforme est responsable de la collecte des exigences, vous disposez d’options supplémentaires pour personnaliser le flux d’inscription, décrites ci-dessous.

Gérer l’acceptation du contrat d’utilisation du service vous-même

Si vous êtes une plateforme qui inscrit des comptes connectés pour lesquels vous êtes responsable de la collecte des exigences, vous pouvez recueillir l’acceptation des Conditions d’utilisation du service par vos propres moyens plutôt qu’en utilisant notre composant d’inscription de compte intégré. Si vous utilisez votre propre processus, lorsque les comptes connectés arrivent sur l’écran final lors de l’inscription, ils sont uniquement invités à confirmer les informations qu’ils ont saisies, et vous devez vous assurer qu’ils acceptent le Contrat d’utilisation du service Stripe.

L’inscription intégrée présente toujours des liens vers les conditions d’utilisation du service (par exemple, dans le pied de page) que vous pouvez remplacer par un lien vers vos propres conditions et politiques de confidentialité.

Lien vers vos contrats et votre politique de confidentialité

Les comptes connectés peuvent consulter le Contrat d’utilisation du service et la Politique de confidentialité de Stripe tout au long de l’inscription intégrée. Dans le cas des comptes connectés pour lesquels vous êtes responsable de la collecte des exigences, vous pouvez remplacer ces liens par vos propres contrats et politiques. Pour ce faire, suivez ces instructions de façon à ajouter le Contrat d’utilisation du service Stripe et à afficher un lien vers la Politique de confidentialité Stripe.

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
curl https://api.stripe.com/v1/account_sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d account=
{{CONNECTED_ACCOUNT_ID}}
\ -d "components[account_onboarding][enabled]"=true

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
// 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.setSkipTermsOfServiceCollection(false) // accountOnboarding.setCollectionOptions({ // fields: 'eventually_due', // futureRequirements: 'include', // }) // accountOnboarding.setOnStepChange((stepChange) => { // console.log(`User entered: ${stepChange.step}`); // });
MéthodeTypeDescriptionPar défaut
setFullTermsOfServiceUrlstringURL absolue vers vos conditions complètes d’utilisation du service.Contrat d’utilisation du service de Stripe
setRecipientTermsOfServiceUrlstringURL absolue vers vos conditions d’utilisation du service pour les bénéficiaires.Contrat d’utilisation du service de Stripe pour les bénéficiaires
setPrivacyPolicyUrlstringURL absolue vers votre politique de confidentialité.Politique de confidentialité de Stripe
setSkipTermsOfServiceCollectionstringSi la valeur est définie sur « true », l’inscription intégrée ignore la récupération des conditions d’utilisation du service et c’est à vous de gérer leur acceptation.false
setCollectionOptions{ fields: 'currently_due' | 'eventually_due', future_requirements: 'omit' | 'include' }Permet de personnaliser la collecte des exigences currently_due ou eventually_due et d’inclure ou non les besoins futurs. Le fait de spécifier eventually_due permet de collecter à la fois les exigences eventually_due et currently_due.{fields: 'currently_due', futureRequirements: 'omit'}
setOnExit() => voidLe compte connecté a quitté le processus d’inscription
setOnStepChange({step}: StepChange) => voidLe compte connecté est passé d’une étape à l’autre au cours du processus d’inscription. Utilisez StepChange pour identifier l’étape en cours, comme décrit ci-dessous.

Pour utiliser ce composant afin de configurer de nouveaux comptes :

  1. Créez un compte connecté. Vous pouvez préremplir les informations de l’objet Account dans cet appel à l’API.
  2. Initialiser les composants intégrés de Connect à l’aide de l’ID du compte connecté.
  3. Incluez l’élément account-onboarding pour que le flux d’inscription s’affiche sur l’écran du compte connecté.
  4. Écoutez l’événement exit émis par ce composant. Stripe envoie cet événement lorsque le compte connecté quitte le processus d’inscription.
  5. Lorsque exit se déclenche, récupérez les informations relatives à Account pour vérifier l’état des éléments suivants :
    • details_submitted
    • charges_enabled
    • payouts_enabled
    • Toute autre fonctionnalité demandée
    Si toutes les fonctionnalités requises sont activées, vous pouvez faire passer le compte connecté à l’étape suivante de votre flux.

L’objet StepChange

Le type StepChange est défini dans connect.js. Chaque fois que le compte connecté passe d’une étape à une autre dans le processus d’inscription, le gestionnaire de changement d’étape reçoit un objet StepChange avec la propriété suivante :

Nom
Type
Exemple de valeur
step
string (doit être un nom d’étape valide)
business_type
La référence unique à l’étape d’inscription des utilisateurs.
Restrictions d’étape
  • L’objet StepChange est uniquement destiné à des fins d’analyse.
  • Les étapes peuvent apparaître dans n’importe quel ordre et se répéter.
  • La liste des noms valides de step peut être modifiée à tout moment, sans préavis.

Noms d’étape

Chaque page d’un flux d’inscription porte l’un des noms d’étape suivants.

Nom de l’étapeDescription
stripe_user_authenticationLors de l’authentification de l’utilisateur, une boîte de dialogue Stripe s’ouvre. Le compte connecté doit s’identifier avant de pouvoir continuer ses activités.
risk_interventionAide le compte connecté à résoudre les exigences liées au risque.
legal_entity_sharingLes comptes connectés peuvent réutiliser les informations sur l’entreprise des comptes existants ayant le même propriétaire.
business_typeDéfinit le type d’entreprise du compte connecté. Dans certains cas, le compte connecté peut également définir son pays.
business_detailsRecueille des informations relatives à l’activité du compte connecté.
business_verificationRecueille un justificatif sur lequel figure l’identifiant de l’entité commerciale, par exemple les statuts de l’entreprise. Ou permet aux utilisateurs de corriger des informations erronées concernant l’entité.
business_bank_account_ownership_verificationRecueille les documents nécessaires pour vérifier que les informations de compte bancaire, telles que le nom du propriétaire et le numéro de compte, correspondent aux informations du compte Stripe de l’utilisateur.
business_documentsRecueille d’autres documents et exigences de vérification liés à l’entreprise.
representative_detailsRecueille des informations sur le représentant du compte.
representative_documentRecueille une pièce d’identité officielle prouvant l’existence du représentant du compte.
representative_additional_documentRecueille un document supplémentaire permettant de vérifier les informations du représentant du compte.
legal_guardian_detailsRecueille le consentement des tuteurs légaux pour les comptes ouverts pour des mineurs.
ownersCollecte des informations sur les bénéficiaires effectifs d’une entreprise.
directorsRecueille des informations sur les administrateurs d’une entreprise.
executivesRecueille des informations sur les dirigeants d’une entreprise.
proof_of_ownership_documentCollecte les documents permettant de vérifier les bénéficiaires effectifs d’une entreprise.
proof_of_authorizationCollecte la documentation permettant de vérifier que le représentant du compte occupe une position d’autorité suffisante au sein de l’entreprise.
confirm_ownersPermet aux comptes connectés d’attester que les informations fournies à Stripe concernant le bénéficiaire effectif sont exactes et à jour.
risa_compliance_survey(S’applique uniquement aux entreprises japonaises.) Répond aux questions concernant la loi révisée sur les ventes à tempérament.
treasury_and_card_issuing_terms_of_serviceRecueille les conditions d’utilisation du service Treasury et d’émission de cartes lors de la demande de ces fonctionnalités.
external_accountCollecte le compte externe du compte connecté.
support_detailsCollecte des informations qui permettent aux clients de reconnaître l’activité des comptes connectés. Ces informations de support peuvent être visibles sur les relevés de paiement, les factures et les reçus.
climatePermet à un compte connecté d’utiliser Stripe Climate.
taxPermet à un compte connecté d’utiliser Stripe Tax.
summaryDernière étape de vérification du flux d’inscription. Le compte connecté peut mettre à jour les informations saisies à cette étape. Les conditions d’utilisation du service et l’URL de confidentialité s’affichent sur cet écran.
summary_riskÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations relatives aux exigences en matière de risque.
summary_business_typeÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations relatives à son type d’entreprise.
summary_businessÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations relatives à son entreprise.
summary_supportÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations publiques relatives à son entreprise.
summary_personsÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations concernant chaque personne figurant sur son compte.
summary_external_accountÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations relatives à son compte externe.
summary_taxÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations relatives à son intégration Stripe Tax.
summary_tax_identification_formÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations relatives à ses informations fiscales certifiées W8/W9. Ces informations s’affichent lorsque Stripe doit collecter des informations W8/W9.
summary_climateÀ partir de l’étape récapitulative, un compte connecté peut mettre à jour les informations relatives à son intégration Stripe Climate.
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc