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
    Test your integration
    Testing use cases
    Sandboxes
      Manage sandboxes
      Manage access and API keys
      Manage organization sandboxes
      Sandbox settings
    Test Apple Pay and Google Pay rendering
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
Stripe Connectors
Partners
Partner ecosystem
Partner certification
HomeDeveloper toolsTestingSandboxes

Manage access and API keys

Manage who can access a sandbox.

Copy page

Use the Stripe Dashboard to grant users access to your sandbox.

Manage access

You can manage access to your sandbox using Team management in your live account’s settings, your live organization’s settings, or directly from a sandbox or organization sandbox.

You can assign a role directly to give a user access to a specific sandbox. You can assign a different role in a sandbox than the one the user holds in other sandboxes or in your live account or organization.

To grant access to organization sandboxes, you must assign the user a role in your live organization.

Manage API keys

Stripe uses the API keys associated with a sandbox to authenticate API requests made to the applicable sandbox environment. We raise an invalid request error if you don’t include a key and an authentication error if the key is incorrect or outdated.

Use the Developer Dashboard within the sandbox to reveal, revoke, and create API keys. Learn more about API keys.

Grant users access to all sandboxes in an account

When you assign the Sandbox Administrator role to a team member in your live account, they gain access to every sandbox linked to that account.

To add more team members to all sandboxes connected to your live account:

  1. Navigate to your live account in the Dashboard.
  2. Click the account picker > Settings in the Dashboard.
  3. Click Team and security > + Add member, then enter one or more email addresses. Select the Sandbox Administrator role.
  4. Click Send invites.

Grant users access to all sandboxes in an organization

When you assign the Sandbox Administrator role to a team member in your live organization, they gain access to every organization sandbox linked to that organization, as well as every sandbox linked to the live accounts within your organization.

To add more team members to all sandboxes and organization sandboxes connected to your live organization:

  1. Navigate to your live organization in the Dashboard.
  2. Click the account picker > Settings in the Dashboard.
  3. Click Team and security > + Add member, then enter one or more email addresses. Select the Sandbox Administrator role.
  4. Click Send invites.

Grant users access for testing only

When you grant a team member the Sandbox User role, you’re granting them access to create sandboxes and delete sandboxes they’ve created.

To invite additional team members to only the sandboxes associated with your live account or organization, without granting access to any details of your live account or organization:

  1. Navigate to your live account or organization in the Dashboard.
  2. Click the account picker > Settings in the Dashboard.
  3. Click Team and security > + Add member, then enter one or more email addresses. Select the Sandbox User role.
  4. Click Send invites.

Grant users access to a specific sandbox

To invite additional team members to a specific sandbox or organization sandbox:

  1. Navigate to the sandbox or organization sandboxes in the Dashboard.
  2. Click the account picker > Settings in the Dashboard.
  3. Click Team and security > + Add member, then enter one or more email addresses and select a role.
  4. Click Send invites.

Note

Stripe automatically assigns the invited user the Sandbox User role in the live account or organization if they don’t already have a live role.

Revoke user access to sandboxes

To revoke a user’s access:

  1. Navigate to the live account, live organization, sandbox, or organization sandbox where that user has a role assignment in the Dashboard.
  2. Click the account picker > Settings in the Dashboard.
  3. Click Team and security, then click the overflow menu ().
  4. Click Remove member to revoke their access.
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