Skip to content
Create account or Sign in
The Stripe Docs logo
/
Ask AI
Create accountSign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
APIs & SDKsHelp
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
API
    Overview
    API v2
    Rate limits
    Authentication
    API keys
      Best practices for API keys
      Restricted API keys
      Managed API keys
      Organization API keys
    Specify request context
    Domains and IP addresses
    Make requests
    Expand responses
    Pagination
    Search objects
    Localize content
    Testing and data
    Metadata
    Test your application
    Error handling
    Handle errors
    Error codes
Testing
Stripe CLI
Tools
Stripe Dashboard
Stripe Projects
Workbench
Developers Dashboard
Stripe for Visual Studio Code
Terraform
Stripe Discord server
Features
Workflows
Batch jobs
Event destinations
Stripe health alertsStripe SignalsFile uploads
AI tools
Agent pluginsModel Context ProtocolAgent skillsStripe Directory
Extend Stripe
Overview
Build Stripe apps
Use apps from Stripe
Build extensions
Custom objects
Security and privacy
Security
Activity logsStripebot web crawler
Privacy
Partners
Partner ecosystem
Partner certification
United States
English (United States)
  1. Home/
  2. Developer resources/
  3. API/
  4. API keys

Managed API keys

Let your hosting platform manage Stripe API keys for you.

Some third-party platforms, such as Vercel, can create and manage API keys on your behalf when you install their integration. These keys are called managed API keys, and the platform creates them programmatically instead of you creating them manually in the Dashboard. Follow your platform’s documentation to understand how it manages your Stripe API keys.

Because a managed key grants access to your Stripe account, you’re responsible for securing it. Make sure you follow best practices to keep these keys safe in your server environment. In particular, if your server platform provides managed API keys to your application as environment variables, don’t expose debugging features or error messages in your application that could show environment variables.

Managed API keys appear alongside your other keys on the API keys tab, labeled with the name of the managing platform. You can’t reveal managed keys because you don’t need them outside the server platform. If you need additional API keys that you can manage, create restricted API keys instead.

The following table summarizes the differences between unmanaged and managed keys.

Unmanaged keysManaged keys
Key creationYou create keys in the DashboardThe platform creates keys using the API
User interactionYou copy keys from the Dashboard and configure them in the platformThe platform handles key setup automatically
Key deliveryDisplayed to you in the DashboardDelivered directly to the platform
Key managementYou control rotation and expirationThe platform manages the key lifecycle; you can expire the keys at any time

Request to join the preview for managed API keys.

Enter your email to request access.

Email
Submit
Privacy policy

Revoke managed key access

You can revoke a managed API key at any time by doing one of the following:

  • Expire the key: On the API keys tab, click the overflow menu () for the managed key and expire it. That immediately revokes the platform’s access without removing the integration.
  • Uninstall the integration: Uninstall the platform’s app from your Stripe account. When you uninstall an app, you can expire the managed keys immediately or keep them active. Retained keys remain active and are your responsibility as the account owner until you expire them from the API keys tab.

See also

  • API keys
  • Best practices for managing secret API keys
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Chat with Stripe developers on Discord.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc