Manage sandboxes

You can use sandboxes for many common development needs. For example, you can:

• Set up a sandbox development environment for each member of your team.
• Establish a sandbox for a team within your organisation.
• Create a sandbox specifically for testing a new Stripe feature or an API upgrade.
• Configure a sandbox that mirrors live mode, allowing you to test and stage changes to your integration before going live or deploying changes to production.

Use the Stripe Dashboard to manage your sandbox.

Create a sandbox

If you have the Sandbox Administrator, Administrator, Developer, or Sandbox User role, you can create a new sandbox. Your account can have up to five sandboxes.

To create a sandbox:

1. Click the account picker > Switch to sandbox > Create sandbox in the Dashboard.
2. Enter a unique name that reflects the purpose of the sandbox (for example, “Staging”) in the Name field.
3. Choose between Copying your account, so you can create a sandbox that copies settings and capabilities from your existing account, or Create an account from scratch, so you can create a sandbox where nothing is copied. Stripe copies these settings by default.
4. Click Create sandbox.

Stripe automatically assigns the Super Administrator role to any user that creates a sandbox. This role allows them to carry out all operations within that particular sandbox.

View a sandbox

If you have the Sandbox Administrator role, you can view all sandboxes. If you have a Developer role, you can only view the sandboxes you’ve created. The roles associated with a sandbox won’t change your access to test mode, allowing all team members to continue accessing test mode.

1. Click the account picker > Switch to sandbox > Manage sandboxes in the Dashboard.
2. Click Open to enter the sandbox.

The banner at the top of the Dashboard indicates that you’re in a sandbox. From here, you can navigate to any other part of the Dashboard.

Update a sandbox

Any member of your team with the Sandbox Administrator role can update the name and details of any sandbox. Developers can only update the name and details of a sandbox that they’ve created.

1. Click the account picker > Switch to sandbox in the Dashboard, then select a sandbox.
2. Click Settings in the top right corner.
3. Update the name or additional details about your sandbox’s account (for example, the branding).

Delete a sandbox

If you have the Administrator or Sandbox Administrator role, you can delete a sandbox. Otherwise, only the sandbox’s owner can delete it.

1. Click the account picker > Switch to sandbox > Manage sandboxes in the Dashboard.
2. Click the trash can icon associated with the sandbox you want to delete.
3. Confirm that you want to delete this sandbox as this action can’t be undone. After deletion, we remove all data associated with the sandbox and revoke access.

Log in to a sandbox in the CLI

You can log in to a sandbox in your CLI by running the following command:

stripe login

Next, click Enter to open a browser and select the sandbox you want to log in to. Then, click Allow access.