Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
API
Testing
    Overview
    Testing
    Testing use cases
    Sandboxes
      Manage sandboxes
      Manage access and API keys
      Manage organization sandboxes
      Sandbox settings
    Test Apple Pay and Google Pay rendering
Stripe CLI
Sample projects
Tools
Workbench
Developers Dashboard
Stripe Shell
Stripe for Visual Studio Code
Features
Workflows
Event destinations
Stripe health alertsFile uploads
AI solutions
Agent toolkit
Model Context Protocol
Security and privacy
Security
Stripebot web crawler
Privacy
Extend Stripe
Build Stripe apps
Use apps from Stripe
Partners
Partner ecosystem
Partner certification
HomeDeveloper resourcesTestingSandboxes

Sandbox settings

Learn about how settings work in sandboxes.

When creating a sandbox, you must choose your starting configuration. 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.

Copy settings and capabilities

Starting with the same settings and capabilities as your existing account eliminates the need to spend time manually verifying that your sandboxes behave like your existing account. We don’t synchronize settings and capabilities. As a result, they can diverge from live settings and capabilities at any time. This allows for testing how settings and capabilities changes affect integration behavior. See the settings and capabilities copied when you chose the Copy your account configuration.

To copy settings and capabilities from your existing account, click Create sandbox > Copy your account. Stripe provides placeholder business data to help you start testing most Stripe features. This sandbox includes placeholder data in the same country as your existing account.

Create a blank sandbox

To create a blank sandbox where nothing is copied from your existing account, click Create sandbox > Create an account from scratch.

Create a sandbox with a country different from your live account

To create a sandbox with a country different from your live account, choose the Create an account from scratch configuration. Then, set the country in the Account details tab of the Business settings for the sandbox.

Sandbox settings management

Stripe copies some settings while excluding others when setting up a new sandbox with the Copy your account configuration.

Payments settings

To open your payments settings in the Dashboard, click Settings > Payments.

Setting up a new sandbox with the Copy your account configuration excludes the following payments settings:

Payment settings pageFunctionality
Checkout and Payment LinksStripe doesn’t copy the Conversion testing program setting. To join this program, adjust this setting in your live account.
Payment methodsStripe enables all payment methods that are enabled or pending in your live account. We automatically enable some payment methods for testing purposes.
Payment method domainsStripe doesn’t copy domains from your live account. You must add a new domain to test it in a sandbox.

Billing settings

To open your billing settings in the Dashboard, click Settings > Billing.

Setting up a new sandbox with the Copy your account configuration excludes the following billing settings:

Billing settings pageFunctionality
Customer portalStripe doesn’t copy domains from your live account. You must add a new domain to test it in a sandbox.
AutomationsStripe doesn’t copy automations or their states from your live account.

Connect settings

To open your Connect settings in the Dashboard, click Settings > Connect.

Setting up a new sandbox with the Copy your account configuration excludes the following Connect settings:

Connect settings pageFunctionality
Onboarding options - OAuthStripe doesn’t copy redirect URIs from your live platform. You must add a redirect URI to test it in a sandbox.
Onboarding options - TaxStripe only copies these settings if Tax is enabled on your live platform.
Tax reportingStripe only copies these settings if Tax is enabled on your live platform.
EmailsStripe doesn’t copy email domains from your live platform. You must add a new email domain to test it in a sandbox.

Business settings

To open your business settings in the Dashboard, click Settings > Business.

Setting up a new sandbox with the Copy your account configuration excludes the following business settings:

Business settings pageFunctionality
Custom domainsStripe doesn’t copy domains from your live account. You must add a new domain to test it in a sandbox.
Public detailsStripe doesn’t copy domains from your live account. Instead, we add placeholder domains to enable payments in a sandbox.

Issuing settings

Stripe only copies Issuing settings if Issuing is enabled on your live platform. To open your Issuing settings in the Dashboard, click Settings > Issuing.

Setting up a new sandbox with the Copy your account configuration the excludes following Issuing settings:

Issuing settings pageFunctionality
Authorization webhooksStripe doesn’t copy authorization webhooks from your live account. You must add new webhook endpoints to test them in a sandbox.
Digital walletsDigital wallets are not available in sandboxes.
Personalization designsStripe doesn’t copy personalization designs from your live account. You must create a new personalization design to test it in a sandbox.

Payouts settings

To open your payouts settings in the Dashboard, click Settings > Business.

Stripe copies the following settings:

Payouts settingFunctionality
Enabled currenciesStripe copies the list of enabled currencies from your live account.
Minmum balances payouts settingsStripe copies the minimum balances settings from your live account.
Payout scheduleStripe copies the payout schedule for your live account.
Custom start of dayStripe copies the custom start of day for transaction availability from your live account.
Instant payouts settingsStripe copies the instant payouts settings and thresholds from your live account.

Capital settings

All Capital settings are copied when you set up a new sandbox with the Copy your account configuration.

Radar settings

No Radar settings are copied when you set up a new sandbox with the Copy your account configuration.

Sigma settings

No Sigma settings are copied when you set up a new sandbox with the Copy your account configuration.

Financial Connections settings

All Financial Connections settings are copied when you set up a new sandbox with the Copy your account configuration.

Tax settings

To open your tax settings in the Dashboard, click Settings > Tax.

Setting up a new sandbox with the Copy your account configuration excludes the following tax setting:

Tax settings pageFunctionality
Origin addressStripe doesn’t copy the original address from your live account. You must add a new origin address to test it in a sandbox.

Account capabilities

Some capabilities enable permanently, meaning you can’t remove them after you request them. Stripe copies the following account capabilities when you set up a new sandbox with the Copy your account configuration:

CapabilityFunctionality
payoutsA sandbox is configured to perform payouts.
link_paymentsA sandbox is configured to process Link payments.
affirm_paymentsA sandbox is configured to process Affirm payments.
us_bank_account_ach_paymentsA sandbox is configured to process ACH Direct Debit payments.
afterpay_clearpay_paymentsA sandbox is configured to process Afterpay Clearpay payments.
p24_paymentsA sandbox is configured to process P24 payments.
transfersA sandbox is configured to transfer funds as a Connect platform to connected accounts.
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