Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Developer tools
SDKs
API
Testing
    Test your integration
    Testing use cases
    Sandboxes
      Manage sandboxes
      Manage access and API keys
      Manage organization sandboxes
      Sandbox settings
    Test Apple Pay and Google Pay rendering
Workbench
Event Destinations
Workflows
Stripe CLI
Stripe Shell
Developers Dashboard
Agent toolkit
Stripe health alertsBuild with LLMsStripe for Visual Studio CodeFile uploads
Security
Security
Extend Stripe
Stripe Apps
Stripe Connectors
Partners
Partner ecosystem
Partner certification
HomeDeveloper toolsTesting

Sandboxes

Test Stripe functionality in an isolated environment.

Copy page

A sandbox is an isolated test environment. You can use your sandbox to test Stripe functionality in your account, and experiment with new features without affecting your live integration. For example, when testing in a sandbox, the payments you create aren’t processed by card networks or payment providers.

Use cases

Sandboxes provide an environment for testing various functionalities and scenarios without the implications of real transactions. Below are some common use cases for sandboxes in your Stripe integrations:

ScenarioDescription
Simulate Stripe events to test without real money movementUse your sandbox to test payments functionality without real money movement. Create payments in your business account to accumulate a fake balance or use test helpers to simulate external events.
Scale isolated sandboxes for teamsYour team can test in separate sandboxes to make sure that data and actions are completely isolated from other sandboxes. Changes made in one sandbox don’t interfere with changes in another.
Invite external usersYou can invite another user, such as an implementation partner or design agency, to access all sandboxes, or a specific sandbox, without providing them access to your live mode data.
Test in the Dashboard or the CLIAccess your sandbox from the Dashboard or the Stripe CLI. Test Stripe functionality directly in the Dashboard or use familiar CLI commands and fixtures.

Manage sandboxes in the Dashboard

To access sandboxes, click Sandboxes within the Dashboard account picker. Depending on your permissions, you can view, create, delete, and open sandboxes from the sandboxes overview page. To manage user access and API keys for a specific sandbox, first open the sandbox and then manage those settings directly within the sandbox. Learn more about managing your sandbox.

Test in a sandbox

You can simulate payments and use test cards to test your integration without moving money. Learn more about using test cards to confirm that your integration works correctly.

Limitations

  • You can’t test IC+ pricing in a sandbox.
  • You can’t create connections between a Connect platform’s sandbox and connected account sandboxes.
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
Related Guides
Testing
Testing use cases