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

Composant de demande CapitalVersion bêta privée

Montrer un flux de demande de bout en bout pour le financement Capital.

Le volet Capital application permet à vos comptes connectés éligibles de remplir une demande de financement dans le site Web ou l’application de votre plateforme. Ils peuvent sélectionner le montant et les conditions de leur offre, consulter les détails contractuels et soumettre leur demande.

Cette composante est semblable à la composante Promotion des capitaux, mais elle invoque directement l’application et exclut le contenu éducatif ou promotionnel. Utilisez cette composante intégrée si vous voulez personnaliser la façon d’afficher l’offre de financement et les informations sur le programme aux comptes connectés admissibles.

Avant de commencer

Installer les composants intégrés Capital

Installez une version bêta des SDK Stripe pour créer des sessions de compte avec des composants de la version bêta privée :

Utilisez la version bêta des bibliothèques côté client de Stripe pour afficher les composants de la version bêta privée :

Installez la bibliothèque :

npm install --save @stripe/connect-js@preview

Si vous utilisez React dans votre application :

npm install --save @stripe/react-connect-js@preview

Configurer Connect.js

Si vous n’utilisez pas encore les composants embarqués Stripe dans votre application, initialisez Connect.js avant d’intégrer le composant application.

Créer une session de compte

Dans votre demande de création de session de compte, spécifiez capital_financing_application dans le paramètre components .

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-11-17.clover; embedded_connect_beta=v2;" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[capital_financing_application][enabled]"=true

Rendre la composante application

Affichez le composant de demande de financement Capital dans le front-end.

capital-financing-application.js
JavaScript
React
No results
// Include this element in your HTML
const capitalFinancingApplication = stripeConnectInstance.create('capital-financing-application');
container.appendChild(capitalFinancingApplication);
Moyen de paiementTypeDescriptionPar défaut
setOnApplicationSubmitted() => voidLe compte connecté a soumis avec succès sa demande de prêt.
setOnApplicationStepChange({step: string}) => voidLe compte connecté a parcouru l’application.
setPrivacyPolicyUrlstringURL absolue d’une page contenant votre politique de confidentialité.https://stripe.com/privacy
setHowCapitalWorksUrlstringURL absolue d’une page contenant des informations sur le programme Capital.https://docs.stripe.com/capital/how-capital-for-platforms-works

Définir l’état d’affichage

Ajoutez le composant d’application sur une page que vos comptes connectés utilisent pour afficher les informations de déclaration des paiements et des paiements, ou une page Financement dédiée dans l’interface utilisateur de votre plateforme. Assurez-vous d’utiliser un emplacement différent du composant de promotion Connect (le cas échéant).

Pour déterminer si un compte connecté est éligible à une offre, appelez le point de terminaison Liste des offres de financement et passez l’ID du compte connecté dans le paramètre compte_connecté.

Le composant applicatif affiche le contenu dynamiquement en fonction de l’état de financement du compte connecté :

  • Pas de financement actif : si un compte n’a pas d’offre de financement admissible, le volet de la demande ne donne pas de résultat (rend nul).

  • Avec offre active : si le compte connecté est éligible à une offre, le composant affiche tous les détails de l’offre avec un bouton Démarrer l’application.

  • Offre en revue : après qu’un compte connecté admissible accepte et demande une offre de financement, utilisez cet état pour afficher un suivi de l’état de la demande. Écoutez l’événement onApplicationStepChange pour suivre l’avancement de son offre. Cet événement est émis lorsque le compte connecté passe à l’étape suivante ou retourne à une étape ou une page précédente du processus de demande de capital. Le nom de l’étape suivante est fourni au gestionnaire que vous fournissez dans le champ étape. Ces étapes peuvent apparaître dans n’importe quel ordre et se répéter. Vous pouvez modifier, ajouter et supprimer les noms d’étape à tout moment.

    N’utilisez l’objet onApplicationStepChange qu’à des fins d’analyse, par exemple pour suivre le temps moyen d’achèvement des pages ou les pages ayant le plus déposé. N’utilisez pas l’objet onApplicationStepChange pour déclencher des workflows opérationnels ou de prise en charge, par exemple pour envoyer des e-mails à des comptes connectés qui ont arrêté la progression de l’application sur une page spécifique.

  • Offre soumise : si un compte connecté a déjà soumis sa demande de prêt, le composant pour la demande de prêt Capital affiche un écran vide. Nous vous recommandons d’écouter l’événement onApplicationSubmitted pour afficher un écran de confirmation.

  • Financement actif en cours : le composant ne rend pas (rend nul).

Le type onApplicationStepChange

Le type onApplicationStepChange est défini dans connect.js. Chaque fois que le compte connecté passe d’une étape à une autre du processus de demande Capital, le gestionnaire de changement d’étape reçoit un objet onApplicationStepChange 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.

Noms d'étape

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

Nom de l’étapeDésignation
stripe_user_authenticationGère l’authentification de l’utilisateur à l’aide d’une fenêtre hébergée par Stripe pour vérifier l’identité et sécuriser le flux de financement.
offer_selectorIntègre les comptes connectés à la demande de financement, en fournissant un aperçu de l’offre et du financement.
offer_summaryAffiche un résumé détaillé de l’offre de financement, y compris les principales conditions générales.
business_detailsCollecte des informations détaillées sur l’entreprise du compte connecté, telles que l’adresse commerciale, le secteur d’activité et les spécificités opérationnelles.
business_verificationRecueille la documentation et les informations qui vérifient l’existence et la légitimité de l’entité commerciale du compte connecté.
business_summaryPermet de vérifier toutes les informations relatives à l’entreprise soumises lors de l’onboarding, et donne au compte connecté la possibilité de confirmer ou de mettre à jour ces informations.
ownersCollecte des informations sur les bénéficiaires effectifs de l’entreprise qui demande un financement.
directorsRecueille des informations sur les dirigeants de l’entreprise, le cas échéant.
executivesCollecte des informations sur les principaux dirigeants associés à l’entreprise.
representative_detailsCollecte des informations sur la personne représentant l’entreprise dans la demande de financement.
representative_additional_documentPermet au compte connecté de télécharger des documents justificatifs attestant de l’identité ou de l’autorité du représentant.
representative_documentCollecte une pièce d’identité officielle ou un document équivalent permettant de vérifier l’identité du représentant de l’entreprise.
person_summaryFournit un aperçu de toutes les informations relatives aux personnes (propriétaires, représentants, dirigeants) soumises, permettant les mises à jour ou les corrections.
offer_annual_revenueCollecte des informations concernant les revenus annuels du compte connecté afin d’évaluer l’éligibilité au financement et les conditions associées.
offer_financial_dataDemande les documents et données financières supplémentaires nécessaires à l’évaluation des risques et à l’approbation de l’offre de financement.
offer_missing_contact_infoInvite le compte connecté à fournir ou à mettre à jour les informations de contact manquantes relatives à la demande de financement.
offer_payout_detailsCollecte les informations de paiement et de virement afin de faciliter le déboursement des fonds de financement sur le compte bancaire du compte connecté.
lending_network_offer_review_agreementsFournit aux comptes connectés les accords spécifiques aux offres de financement obtenues via le Réseau de prêt de Stripe pour vérification et acceptation.
offer_review_agreementsPrésente les accords et conditions juridiques relatifs à l’offre de financement sélectionnée pour vérification et acceptation par le compte connecté.
offer_completeConfirme que l’offre de financement a été soumise et que la procédure de demande est terminée.

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 d’étapes valides peut changer à tout moment, sans préavis.

Soumettre la composante à l'examen

Pour utiliser l’un des composants Capital en mode live, Stripe et ses partenaires financiers doivent examiner et approuver tous les contenus orientés clients qui font référence à Stripe Capital :

  1. Créez une offre de test dans un environnement de test, et définissez le statut de l’offre sur livré. Utilisez cette offre de test pour prévisualiser le composant applicatif dans le site Web ou le Dashboard de votre plateforme.
  2. Capturez un aperçu de l’offre de l’environnement de test et de la façon dont le composant intégré s’affiche dans l’interface utilisateur de votre plateforme (comme des captures d’écran ou une vidéo enregistrée).
  3. Soumettre l’aperçu à Stripe. Après approbation, Stripe vous permet d’utiliser le composant en mode live.

FacultatifComposants intégrés supplémentaires

Le composant applicatif est l’un des nombreux composants embarqués disponibles pour Capital pour les plateformes. Par exemple, vous pouvez intégrer le composant Capital financing, qui permet à vos comptes connectés de gérer leurs paiements et de consulter l’historique des transactions.

Voir aussi