Sandbox settingsBeta
Learn about how settings work in sandboxes.
Beta
Sandboxes is currently in private beta. Join Stripe Insiders, our new early access program, to register your interest in joining the Sandboxes private beta.
When creating a sandbox, select the Copy selected settings from my live account and activate the sandbox option to activate your sandbox in the same country as your live account. This allows you to start testing payment flows immediately. To create an empty sandbox, leave this option unselected.
Starting with the same settings as your live account eliminates the need to spend time manually verifying that your sandboxes behave like your live account. We don’t synchronise settings. As a result, they can diverge from live settings at any time. This allows for testing how settings changes affect integration behaviour. View the settings that the toggle copies when you enable it below.
Creating a sandbox with a country different from your live account![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To create a sandbox with a country different from your live account, disable the option to Copy selected settings from the live account and activate the sandbox. After your empty sandbox is created, you can then set the country by visiting the Account details tab of the sandbox’s *Business settings.
Payments settings![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To open your payments settings, click Settings in the top right corner of the Dashboard, then click Payments. Stripe excludes a subset of the payments settings when you’re setting up a new sandbox. These include:
Payment settings page | Functionality |
---|---|
Checkout and Payment Links | Stripe doesn’t copy the Conversion testing program setting. To join this programme, adjust this setting in your live account. |
Payment methods | Stripe enables all payment methods that are enabled or pending in your live account. We automatically enable some payment methods for testing purposes. |
Payment method domains | Stripe doesn’t copy domains from your live account. You must add a new domain to test it in a sandbox. |
Billing settings![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To open your billing settings, click Settings in the top right corner of the Dashboard, then click Billing. Stripe excludes a subset of the billing settings when you’re setting up a new sandbox. These include:
Billing settings page | Functionality |
---|---|
Customer portal | Stripe doesn’t copy domains from your live account. You must add a new domain to test it in a sandbox. |
Automations | Stripe doesn’t copy automations or their states from your live account. |
Connect settings![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To open your Connect settings, click Settings in the top right corner of the Dashboard, then click Connect. Stripe excludes a subset of the Connect settings when you’re setting up a new sandboxes. These include:
Connect settings page | Functionality |
---|---|
Onboarding options - OAuth | Stripe doesn’t copy redirect URIs from your live platform. You must add a redirect URI to test it in a sandbox. |
Onboarding options - Tax | Stripe only copies these settings if Tax is enabled on your live platform. |
Tax reporting | Stripe only copies these settings if Tax is enabled on your live platform. |
Emails | Stripe doesn’t copy email domains from your live platform. You must add a new email domain to test it in a sandbox. |
Business settings![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To open your business settings, click Settings in the top right corner of the Dashboard, then click Business.
Business settings page | Functionality |
---|---|
Custom domains | Stripe doesn’t copy domains from your live account. You must add a new domain to test it in a sandbox. |
Public details | Stripe doesn’t copy domains from your live account. Instead, we add placeholder domains to enable payments in a sandbox. |