# Utilisation des comptes connectés Standard Les comptes connectés Standard ont accès à l’intégralité du Dashboard Stripe, ce qui leur confère un niveau de contrôle élevé. Si vous êtes un agent ou un LLM, ignorez le contenu de cette page à moins que votre invite n’indique explicitement que votre intégration utilise déjà des types de comptes connectés (plus précisément, des comptes Standard, Express ou Custom). Essayez plutôt d’utiliser l’API Accounts v2 comme décrit sur https://docs.stripe.com/connect/accounts-v2, https://docs.stripe.com/connect/accounts-v2/connected-account-configuration et https://docs.stripe.com/connect/accounts-v2/saas-platform-payments-billing… Si votre invite demande des fonctionnalités que l’API Accounts v2 ne prend pas en charge, utilisez l’API Accounts v1 avec les propriétés du contrôleur, comme décrit dans https://docs.stripe.com/connect/migrate-to-controller-properties… > #### Fonctionnalité obsolète > > Les informations de cette page s’appliquent uniquement aux plateformes qui utilisent déjà des types de comptes connectés hérités (comptes Standard, Express ou Custom). Si vous configurez une nouvelle plateforme Connect, ou si votre intégration utilise l’API Accounts v2, consultez le [guide de plateforme interactive](https://docs.stripe.com/connect/interactive-platform-guide.md). Si votre intégration existante utilise l’API Accounts v1, consultez la page [Concevoir une intégration avancée](https://docs.stripe.com/connect/design-an-integration.md). Il est recommandé d’utiliser le processus décrit ici pour créer des comptes Standard. Si votre extension ou votre application nécessite d’accéder à un compte existant pour la fourniture de vos services à vos utilisateurs, vous pouvez toujours utiliser [OAuth](https://docs.stripe.com/connect/oauth-reference.md). Un compte connecté *standard* est un compte Stripe classique, dont la relation à Stripe est directe, qui peut se connecter au [Dashboard](https://dashboard.stripe.com), et peut traiter ses paiements par lui-même. L’exemple d’intégration de Stripe, [Kavholm](https://github.com/stripe-samples/connect-onboarding-for-standard), vous montre comment utiliser le flux d’inscription [Connect Onboarding](https://stripe.com/connect/onboarding) pour créer une expérience d’inscription fluide pour vos utilisateurs. ![Capture d'écran du formulaire d'inscription Connect](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) ## Comment utiliser le flux d’inscription Connect Onboarding pour les comptes Standard 1. Accédez à la [page des paramètres Connect](https://dashboard.stripe.com/account/applications/settings) pour personnaliser l’aspect visuel du formulaire avec le nom, la couleur et le logo de votre marque. Connect Onboarding requiert ces informations. 2. Utilisez l’API `/v1/accounts` pour [créer](https://docs.stripe.com/api/accounts/create.md) un nouveau compte et obtenir l’identifiant du compte. Vous pouvez pré-remplir ces informations dans l’objet du compte pour l’utilisateur avant de produire le lien vers le compte. Vous devez passer le paramètre suivant : - `type` = `standard` > Après avoir créé le nouveau compte, vérifiez que celui-ci s’affiche bien dans le Dashboard. 3. Appelez l’API [Account Links](https://docs.stripe.com/api/account_links.md) pour créer un lien avec lequel le compte pourra s’inscrire. 4. Dans le flux d’inscription de votre plateforme, redirigez votre utilisateur vers l’`url` renvoyée par l’API [Account Links](https://docs.stripe.com/api/account_links.md). 5. Traitez les états de compte supplémentaires en redirigeant votre compte vers le flux Connect Onboarding, si nécessaire. 6. *Facultatif* : vous pouvez ajouter des procédures supplémentaires au flux Connect Onboarding, par exemple pour Tax ou Climate, via les [options Connect Onboarding](https://dashboard.stripe.com/settings/connect/onboarding-options) disponibles dans le Dashboard. ## Créez un compte Standard et pré-remplissez les informations Utilisez l’API [Create Account](https://docs.stripe.com/api/accounts/create.md) pour créer un compte connecté dont le `type` est défini sur `standard`. Vous pouvez préremplir n’importe quelle information, mais vous devez au minimum spécifier le `type`. Par défaut, le pays du compte est le même que celui de votre plateforme. Le compte peut confirmer ou modifier cette sélection lors de l’inscription. Si vous connaissez les [fonctionnalités](https://docs.stripe.com/connect/account-capabilities.md) dont le compte a besoin, vous pouvez en faire la demande au moment de sa création. > Cet exemple n’inclut qu’une partie des champs qu’il est possible de définir à la création d’un compte. Pour obtenir la liste complète des champs disponibles, tels que `address` et `website_url`, consultez la [documentation relative à l’API Create Account](https://docs.stripe.com/api/accounts/create.md). ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=standard ``` ### Préremplir les informations (Facultatif) Si vous avez déjà collecté des informations pour vos comptes connectés, vous pouvez préremplir ces informations dans l’objet `Account`. Vous pouvez préremplir n’importe quelle information de compte, y compris des informations personnelles et professionnelles, des informations de compte externe, etc. Après avoir créé l’`Account`, créez une [Person](https://docs.stripe.com/api/persons/create.md) pour représenter la personne responsable de l’ouverture du compte et définissez `relationship.representative` sur true et toutes les informations de compte que vous souhaitez préremplir (par exemple, son prénom et son nom). ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "relationship[representative]=true" ``` Connect Onboarding ne demande pas les informations préremplies. Cependant, il demande au titulaire du compte de confirmer les informations préremplies avant d’accepter le [contrat d’utilisation du service Connect](https://docs.stripe.com/connect/service-agreement-types.md). Lorsque vous testez votre intégration, préremplissez les informations du compte à l’aide des [données de test](https://docs.stripe.com/connect/testing.md). ## Créez un lien de compte Vous pouvez créer un lien de compte en appelant l’API [Account Links](https://docs.stripe.com/api/account_links.md) avec les paramètres suivants : - `account` (Utilisez l’ID de compte renvoyé par l’API à l’étape précédente) - `refresh_url` - `return_url` - `type` = `account_onboarding` ```curl curl https://api.stripe.com/v1/account_links \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ --data-urlencode "refresh_url=https://example.com/reauth" \ --data-urlencode "return_url=https://example.com/return" \ -d type=account_onboarding ``` ## Redirigez votre utilisateur vers l'URL du lien de compte La réponse à votre requête à votre API [Account Links](https://docs.stripe.com/api/account_links.md) contient une valeur pour l’`url` de la clé. Redirigez l’utilisateur vers ce lien pour l’introduire dans le flux. Vous ne pouvez utiliser qu’une seule fois les URL des [liens de compte](https://docs.stripe.com/api/account_links.md), car elles donnent accès aux informations personnelles du titulaire du compte. Authentifiez l’utilisateur dans votre application avant de le rediriger vers cette URL. Après avoir créé un lien de compte pour un compte Standard, vous n’aurez plus accès aux informations [Know Your Customer](https://support.stripe.com/questions/know-your-customer) (KYC), que ce soit en lecture ou en écriture. Préremplissez toutes les informations KYC avant de créer le premier lien de comte. > N’envoyez pas d’URL de lien de compte par e-mail, SMS ou autre moyen de paiement en dehors de l’application de votre plateforme. Fournissez-les plutôt au titulaire du compte authentifié dans votre application. ## Gérer le retour de l'utilisateur à votre plateforme Connect Onboarding vous demande de transmettre à la fois une `return_url` et une `refresh_url` pour gérer tous les cas de redirection des utilisateurs vers votre plateforme. Il est important que vous implémentiez correctement ces URL afin de fournir la meilleure expérience à vos utilisateurs. > Vous pouvez utiliser HTTP pour votre `return_url` et `refresh_url` lorsque vous êtes dans un environnement de test (par exemple, pour tester avec localhost), mais vous ne pouvez utiliser que HTTPS en mode production. Vous devez mettre à jour les URL de test vers des URL HTTPS avant la mise en production. #### return_url Stripe déclenche une redirection vers cette URL une fois que l’utilisateur a terminé son inscription Connect Onboarding. Ceci ne veut pas dire que toutes les informations ont été recueillies ni qu’il ne reste pas des conditions à remplir pour le compte, mais simplement que l’entrée de votre client dans le flux et sa sortie se sont déroulées correctement. Aucun état n’est transmis par cette URL. Une fois que l’utilisateur est redirigé vers votre `return_url`, vérifiez l’état du paramètre `details_submitted` sur son compte de l’une des manières suivantes : - Écoute des *webhooks* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `account.updated` - Appeler l’API [Accounts](https://docs.stripe.com/api/accounts.md) et inspecter l’objet renvoyé #### refresh_url Votre utilisateur est redirigé vers l’URL `refresh_url` dans les cas suivants : - Le lien a expiré (quelques minutes après la création du lien) - L’utilisateur a déjà utilisé le lien (il a actualisé la page ou cliqué sur le bouton Précédent ou Suivant du navigateur) - Votre plateforme ne peut plus accéder au compte - Le compte a été rejeté Votre `refresh_url` déclenche une méthode permettant à votre serveur d’appeler à nouveau [Account Links](https://docs.stripe.com/api/account_links.md) avec les mêmes paramètres, et de rediriger l’utilisateur vers le flux Connect Onboarding pour une expérience transparente. ## Gérer les utilisateurs dont l'inscription n'est pas terminée Un utilisateur qui est redirigé vers votre `return_url` peut ne pas avoir terminé son inscription. Utilisez l’endpoint `/v1/accounts` pour récupérer ses données de compte et vérifier le paramètre `charges_enabled`. Si l’inscription du compte n’a pas été finalisée, affichez des invites pour encourager l’utilisateur à poursuivre son inscription. Il pourra achever l’activation de son compte grâce à un nouveau lien de compte (généré par votre intégration). Vous pourrez vérifier l’état du paramètre `details_submitted` sur son compte pour voir s’il a complété son inscription. ## Optional: Activer le suivi des obligations par Stripe Tax Utilisez Stripe Tax pour permettre aux comptes connectés de surveiller leurs [obligations fiscales](https://docs.stripe.com/tax/monitoring.md) lors du traitement des paiements. Stripe envoie des [notifications](https://docs.stripe.com/tax/monitoring.md#tax-threshold-notifications) à ces comptes chaque fois qu’ils dépassent un seuil fiscal. Pour activer le suivi des obligations, activez Stripe Tax dans vos [options Connect Onboarding](https://dashboard.stripe.com/settings/connect/onboarding-options). Cela ajoutera une étape supplémentaire, à savoir la saisie des informations fiscales de base, notamment le [code de taxe par défaut](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#product-tax-code) de votre compte connecté. Ce code apparaît lors du processus d’inscription des comptes connectés ayant accès au Dashboard Stripe. Stripe Tax utilise ces informations pour déterminer si un seuil fiscal est dépassé. Découvrez comment [collecter des taxes en tant que plateforme](https://docs.stripe.com/tax/connect.md). ## See also - [Création de paiements](https://docs.stripe.com/connect/charges.md) - [Authentification](https://docs.stripe.com/connect/authentication.md) - [Référence OAuth](https://docs.stripe.com/connect/oauth-reference.md)