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.
Set environment variable:
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:
Replace sandbox API keys with production keys.
Double-check your environment variables.
Confirm that only approved team members have access.
Summary:
Use Sandbox for safe, unlimited testing.
Use Production for live customers and payments.
Always test thoroughly in Sandbox before going live.