Manage organization sandboxesDeveloper preview

You can use organization sandboxes for many common development needs. You can create an organization sandbox to:

• Test your integration across multiple sandboxes in an organization sandbox and try Stripe Organizations features, such as customer and payment method sharing.
• Mirror your live organization to test and stage changes to your integration before going live or deploying changes to production.
• Provide a development environment for each member of your team.
• Support a specific team within your organization.

Use the Stripe Dashboard to manage your organization sandbox. To test an organization, you must create an organization sandbox from the live organization. User access to organization sandboxes is managed at the live organization as well. You can’t move existing sandboxes you have created in each live account to an organization sandbox.

After you create both sandboxes linked to your live account and organization sandboxes, your overall account structure might look like this:

Create an organization sandbox

If you have the Sandbox Administrator, Administrator, Developer, or Sandbox User role assigned in your live organization, you can create a new organization sandbox.

To create a sandbox:

1. From your organization Dashboard, click the account picker > Switch to sandbox > Create sandbox.
2. Choose a type of sandbox. Select Organization to set up an organization sandbox to test functionality available on your live organization. Click Continue.
3. Enter a unique name that reflects the purpose of the organization sandbox (for example, “Staging”) in the Name field.
4. Choose how to apply settings:
   • Copy my organization structure creates the organization sandbox that mimics your entire live organization, including sandboxes for each live account and all corresponding settings and capabilities. This is the default.
   • Blank creates the organization sandbox as an empty container with no pre-configurations.
5. Configure account sandboxes:
   • Copy my organization structure: Choose whether to include sandboxes for all accounts in the org (default) or deselect individual accounts to omit sandboxes for them.
   • Blank: You can optionally include blank account sandboxes with minimal sample data. Specify a business location and name for each account sandbox you want to build with the blank organization sandbox.
6. 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 an organization sandbox

If you have the Administrator or Sandbox Administrator role, you can view all sandboxes and organization sandboxes in your live organization. If you have a Developer role, you can only view the sandboxes and organization sandboxes you’ve created.

1. From your organization Dashboard, click the account picker > Switch to sandbox > Manage sandboxes in the Dashboard.
2. Click Open to enter the sandbox organization.

Sandboxes that you create for each live account don’t appear when you’re in the live organization. Only organization sandboxes remain visible while you’re in the live organization. The banner at the top of the Dashboard indicates that you’re in a sandbox. From this point, you can navigate to any other part of the Dashboard.

Update an organization sandbox

Any member of your team with the Sandbox Administrator role assigned in your live organization can update the name and details of any organization sandbox. Members with the Developer role can only update the name and details of an organization sandbox that they’ve created.

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

Delete an organization sandbox

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

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