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 organization.
• 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 who 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 youve created. The roles associated with a sandbox wont 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 youre in a sandbox. From here, you can go 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 theyve 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 sandboxs 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 sandboxs owner can delete it.

1. Click the account picker > Switch to sandbox > Manage sandboxes in the Dashboard.
2. Open the overflow menu () for the sandbox you want to delete, then select Delete. Confirm the deletion. You cant undo this action.

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.