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 alertsBuild 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

Add deep links

Create deep links that navigate users to your Stripe app.

Copy page

A deep link is a URL that reduces the number of navigation steps required for the user to open your app in the Dashboard. You can share deep links in user interfaces such as an email or website or use them when creating OAuth authorization workflows.

Before you begin

To navigate users to a Dashboard page that displays your app, you need an app with UI functionality.

Create the deep link URL

To create the URL of the deep link, you must use:

  • The URL of a Dashboard page where you’ve defined a view
  • The open_drawer_app parameter
  • Your application ID, which is specified in the id field of your stripe-app.json manifest file

For example, if you define a view on the Customers page in the Dashboard (https://dashboard.stripe.com/test/customers?) and your application ID is com.example.deep-link:

  • The test mode and sandbox deep link is:

    <a href="https://dashboard.stripe.com/test/customers?open_drawer_app=com.example.deep-link">Deep Link</a>
  • The live mode deep link is:

    <a href="https://dashboard.stripe.com/customers?open_drawer_app=com.example.deep-link">Deep Link</a>

If a user clicks one of the deep links, it navigates them to your app that opens in the Customers page of the Dashboard.

Share the deep link

Make sure you use the live mode URL when you share the deep link to your users. You can share the link anywhere for users who’ve installed your app. If the user hasn’t installed your app before clicking the deep link, Stripe navigates them to a closed app that can’t open in the Dashboard.

Test the deep link

  1. Log in to the Dashboard as a user who has installed the app.

  2. Click the deep link.

    If it navigates you to an app that can’t open, make sure you set the open_drawer_app parameter to the correct application ID.

See also

  • App manifest reference
  • 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