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
Automatisation des opérations financières
Plateformes et places de marché
Gestion de fonds
Outils de développement
Démarrer
Paiements
Automatisation des opérations financières
Démarrer
Paiements
Automatisation des opérations financières
Plateformes et places de marché
Gestion de fonds
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 avec taxe
      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

Remarque

Cette page n'est pas encore disponible dans cette langue. Nous faisons tout notre possible pour proposer notre documentation dans davantage de langues et nous vous fournirons la version traduite dès qu'elle sera disponible.

App installVersion bêta privée

Show a button to install an app.

Copier la page

App install renders a component that enables your connected account to install an app. App install is a private preview component that requires using preview versions of Stripe SDKs. Read more about private preview components.

For full integration details, see the Embedded Stripe Apps integration guide.

Create an Account Session

When creating an Account Session, enable the App install component by specifying app_install in the components parameter. You must enable the app you want to install by specifying the features parameter under allowed_apps.

Command Line
cURL
curl https://api.stripe.com/v1/account_sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Version: 2025-05-28.basil; embedded_connect_beta=v2;" \ -d account=
{{CONNECTED_ACCOUNT_ID}}
\ -d "components[app_install][enabled]"=true \ -d "components[app_install][features][allowed_apps][]"=APP_ID

After creating the account session and initializing ConnectJS, you can render the App install component in the front end:

app-install.js
JavaScript
const appInstall = stripeConnectInstance.create('app-install'); appInstall.setApp('{{APP_ID}}'); container.appendChild(appInstall);

This embedded component supports the following parameters:

MethodTypeDescription
setAppstringSets the ID of the App your connected account can install. See the list of available apps.

You can configure custom behavior based on the current or updated state of an install.

app-install.js
JavaScript
// index.html <div id="app-install-container"></div> // index.js // Do something when install state fetched on render const handleAppInstallFetched = (response) => { console.log(`Install state fetched for app ${response.appId} to ${response.state}`); }; // Do something when install state changes const handleAppInstallChanged = (response) => { console.log(`Install state changed for app ${response.appId} to ${response.state}`); }; const container = document.getElementById('app-install-container'); const appInstall = stripeConnectInstance.create('app-install'); appInstall.setApp('{{APP_ID}}'); appInstall.setOnAppInstallStateFetched(handleAppInstallFetched); appInstall.setOnAppInstallStateChanged(handleAppInstallChanged); container.appendChild(appInstall);
MethodDescriptionVariables
setOnAppInstallStateFetchedAllows users to specify custom behavior in a callback function on install fetch.
  • response.appId: The app installed
  • response.state: The state of the install INSTALLED | UNINSTALLED
setOnAppInstallStateChangedAllows users to specify custom behavior in a callback function when the install state has changed.
  • response.appId: The app installed
  • response.state: The state of the install INSTALLED | UNINSTALLED

You can integrate our sample app (set APP_ID to stripe.app-explorer), which we’ve pre-approved for embedding on your platform.

Request early access Private preview

Sign in to request access to this Connect embedded component in preview.

If you don’t have a Stripe account, you can register now.

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