Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Developer tools
SDKs
API
Testing
Workbench
Event Destinations
Workflows
Stripe CLI
Stripe Shell
Developers Dashboard
Agent toolkit
Stripe health alertsBuilding with LLMsStripe for Visual Studio CodeFile uploads
Security
Security
Extend Stripe
Stripe Apps
    Overview
    Get started
    Create an app
    How Stripe Apps work
    Sample apps
    Build an app
    Store secrets
    API authentication methods
    Authorization flows
    Server-side logic
    Listen to events
    Handle different modes
    Enable sandbox support
    App settings page
    Build a UI
    Onboarding
    Distribute your app
    Distribution options
    Upload your app
    Versions and releases
    Test your app
    Publish your app
    Promote your app
    Add deep links
    Create install links
    Assign roles in UI extensions
    Post-install actions
    App analytics
    Embedded components for Apps
    Embed third-party Stripe Apps
    Migrating to Stripe Apps
    Migrate or build an extension
    Migrate a plugin to Stripe Apps or Stripe Connect
    Reference
    App manifest
    CLI
    Extension SDK
    Permissions
    Viewports
    Design patterns
    Components
Stripe Connectors
Partners
Partner ecosystem
Partner certification
HomeDeveloper toolsStripe Apps

Upload and install your Stripe App

Make your app available to team members on your Stripe account.

Copy page

Some Stripe Apps features also require you to upload your app. For more information, see:

  • Store secrets
  • Add server-side functionality

To share your app with your team members, install it on your Stripe account with two steps:

  • Upload your app in test mode
  • Install in live mode

Any team member with access to your Stripe account can run your installed apps. To give other Stripe accounts access, you can publish your app on the Stripe App Marketplace. Your app ID must be globally unique.

Upload your app in test mode

To upload your app, run the following command from your project root directory:

Command Line
stripe apps upload

Stripe validates your app manifest, which defaults to test mode availability on your Stripe account. After validation is complete, you see a banner with a prompt and button to install the new version into test mode. You can configure the app manifest to allow installation into sandboxes.

You can install previous versions though the Version History list.

  1. In the version history table, click the overflow menu () of the version you want to install.
  2. Select Install in test mode and complete the installation.

After this step:

  • Any team member can access your app in test mode at https://dashboard.stripe.com/test/.
  • Your app can store secrets in test mode.
  • You can access your app’s signing secret to connect it to a backend.

Install in live mode

To access real customer data, install your app in live mode.

  1. Select your app from the Apps page in the Developers Dashboard.
  2. Select the Private to your account option when choosing how to distribute.
  3. Choose a version for your app and click Continue.
  4. Click Continue to open your app in the Dashboard, then click Install.
  5. Click Done, refresh your browser, and see your app in live mode across the Dashboard in the right-hand side drawer.

After this step:

  • Any team member can access your app in live mode in the Dashboard.
  • Your app can store secrets in live mode.
  • Your app’s signing secret remains available.

Uninstall your app in live mode

To switch between installing your app in live mode to publishing it on the Stripe App Marketplace, uninstall the app in live mode:

  1. Go to the Installed Apps page in the Dashboard, and find the app you want to uninstall.
  2. Click the overflow menu at the right side of your app, and click View app details.
  3. Click Uninstall app, and click Uninstall.

After this step, you can publish your app to the Stripe App Marketplace.

See also

  • Add deep links
  • Versions and releases
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc