Getting started

Sandbox vs. Production

Understand the difference between testing in Sandbox mode and running live transactions in Production.

Our platform provides two environments — Sandbox and Production — to help you test, develop, and scale safely. Understanding how and when to use each is crucial for smooth operations.

What is Sandbox?

The Sandbox environment is a safe testing space that simulates real-world behavior without processing actual money or data.

🔑 Key Features:

  • No real charges, refunds, or payouts.

  • Use of test cards and mock transactions.

  • Free and unlimited access for developers.

Sandbox is ideal for development, QA, and staging. Use it to test API calls, payment flows, and error handling before going live.

What is Production?

The Production environment is your live system — all real transactions, customer data, and payouts are handled here.

Key Features:

  • Real payments and subscriptions.

  • Actual customer and account data.

  • Linked directly to your payouts.

⚠️ Warning: Any mistakes in Production (like accidental charges or refunds) will affect real customers and money.

Comparison Table

Feature

Sandbox

Production

Transactions

Simulated, no real money

Live, real money processed

Data

Mock/test customers & accounts

Real customer & account data

Use Case

Development, testing, QA

Live operations with real customers

Risk Level

None

High — real-world consequences

Switching Between Environments

You can easily toggle between Sandbox and Production using API keys and environment variables.

# Sandbox API endpoint
https://api.saasapp.com/sandbox/v1/

# Production API endpoint
https://api.saasapp.com/v1/

Set environment variable:

export APP_ENV=sandbox   # for testing  
export APP_ENV=production # for live use

Testing in Sandbox

When working in Sandbox, you can use test payment methods.

Example Test Card

Card Number

Result

4242 4242 4242 4242

Successful payment

4000 0000 0000 0002

Declined transaction

4000 0000 0000 0341

Requires authentication

Tip: Always simulate edge cases (failed payments, authentication requests) before launching.

Going Live

When you’re ready to switch to Production:

  1. Replace sandbox API keys with production keys.

  2. Double-check your environment variables.

  3. Confirm that only approved team members have access.

# Example live request
curl -X POST https://api.saasapp.com/v1/transactions \
  -H "Authorization: Bearer PROD_KEY_67890"

Summary:

  • Use Sandbox for safe, unlimited testing.

  • Use Production for live customers and payments.

  • Always test thoroughly in Sandbox before going live.

Need help? Contact Support

Questions? Contact Sales

On this page

Create a free website with Framer, the website builder loved by startups, designers and agencies.