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

Composant de promotion CapitalVersion bêta privée

Afficher du contenu promotionnel sur l'offre de financement Capital d'un compte connecté et lancer une demande de prêt Capital.

Le volet Promotion du capital permet à vos comptes connectés admissibles de remplir une demande de financement dans le site Web ou l’application de votre plateforme. Les comptes connectés peuvent sélectionner le montant et les modalités de leur offre, consulter les détails contractuels et soumettre leur demande. Ce volet affiche du contenu éducatif et promotionnel sur le programme Capital comme point de départ du processus de demande.

Composants alternatifs

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 session de compte, spécifiez capital_financement_promotion dans le paramètre composants .

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_promotion][enabled]"=true

Rendu du composant

Affichez le composant de promotion du capital dans le front-end :

capital-financing-promotion.js
JavaScript
React
No results
// Include this element in your HTML
const capitalFinancingPromotion = stripeConnectInstance.create('capital-financing-promotion');
container.appendChild(capitalFinancingPromotion);
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.
setLayoutfull | bannerContrôle la disposition du composant. Le mode banner réduit considérablement la taille verticale du composant, ce qui est utile pour ajouter le composant à d’autres contenus sur la page.full
setOnEligibleFinancingOfferLoaded({productType: standard | refill | none}) => voidL’offre de financement du compte connecté a été chargée. Le champ productType correspond au champ product_type sur l’objet Offre de financement.
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
setEligibilityCriteriaUrlstringURL absolue d’une page contenant des informations sur les critères d’admissibilité au programme Capital.https://docs.stripe.com/capital/how-capital-for-platforms-works

Définir l’état d’affichage

Ajoutez le volet promotion sur la page d’accueil de votre plateforme, ou une page dédiée Financement dans le site ou l’application de votre plateforme. Le volet application affiche le contenu dynamiquement en fonction de l’état de financement du compte connecté :

  • Pas de financement actif : si le compte connecté n’a pas de financement actif, le composant affiche des informations génériques sur l’admissibilité et le programme de prêt.

  • 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 : après qu’un compte connecté ait soumis sa demande de financement, le composant affiche un écran vide. Écoutez l’événement onApplicationSubmitted pour afficher un écran de confirmation à la place.

  • 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 volet promotion est l’un des nombreux composants intégrés disponibles pour Capital pour les plateformes. Par exemple, vous pouvez intégrer le composant financement capital, qui permet à vos comptes connectés de gérer leurs paiements et de consulter l’historique des transactions.

Voir aussi