Skip to main content
Every developer’s journey with ZBD starts in the sandbox. It’s your risk-free playground where you can test payments, break things, and perfect your integration before touching real money.
Default Environment: All new projects start as sandbox projects. This protects you from accidentally spending real Bitcoin while learning the platform.

​
What Makes Sandbox Special

Fake Bitcoin

10,000 free satoshis to start, top up anytime

Test Users

Pre-created users with wallets for end-to-end testing

​
Visual Indicators

Sandbox projects are clearly marked to prevent confusion:
Sandbox Project Created
Look for:
  • 🧪 “Sandbox” label on project cards
  • 🎮 Test Bitcoin balance (not real money!)
  • 👥 Test Users tab only in sandbox
  • 🔑 Sandbox API endpoints in documentation

​
Sandbox Architecture

​
Getting Started with Sandbox

​
Your First Sandbox Project

When you create your first project, you’ll automatically get:
1

Sandbox Wallet

Pre-funded with 10,000 fake satoshis
2

Sandbox API Key

Works only with sandbox endpoints
3

Test Users

5 pre-created users with ZBD gamertags
4

Full API Access

All payment features available for testing

​
Test Users

Click the Test Users tab to see your pre-created testing accounts:
Sandbox Test Users
Each test user has:
  • Unique ZBD Gamertag
  • Test wallet with balance
  • Ability to receive payments
  • Full transaction history
Example Test Users: 
- SandboxUser1#7823
- TestPlayer42#1337  
- DevTester99#2024

​
Topping Up Your Sandbox

Running low on fake satoshis? Add more instantly:
Topup Sandbox Wallet

Instant Top-up

Click “Top Up” for +10,000 sats instantly

Unlimited Refills

No limits - top up as many times as needed

​
Sandbox API Endpoints

Sandbox uses separate endpoints to ensure you never accidentally mix test and production: 
Base URL: https://sandbox.api.zbdpay.com

Example endpoints:
- /v0/gamertag/send
Currently Limited: Only the Send to Gamertag API is available in sandbox. More endpoints coming soon. For full API testing, complete verification for production access.

​
Testing Payments in Sandbox

Let’s send your first test payment:

​
1. Get Your Sandbox API Key

Sandbox API Key

​
2. Send Test Payment

Use the API Playground or your own code: 
curl -X POST https://sandbox.api.zbdpay.com/v0/gamertag/send \
  -H "apikey: YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gamertag": "SandboxUser1#7823",
    "amount": "100",
    "description": "Test payment!"
  }'

​
3. Verify Success

Check your sandbox wallet to see the transaction:
Sandbox Wallet After Transaction
Click on the transaction for full details:
Sandbox Transaction Details

​
Transitioning to Production

Ready to handle real money? Here’s your checklist:
1

Complete Testing

  • All payment flows tested
  • Error handling verified
  • Webhook integration working
  • Performance acceptable
2

Verify Identity

Complete KYB process for production access
3

Create Production Project

New project with production API key
4

Update Your Code

  • Change API endpoints
  • Update API key
  • Enable production monitoring
  • Set up error alerts
5

Go Live!

Start with small real transactions

​
Troubleshooting Sandbox

API Key Not Working

Ensure you’re using sandbox endpoints with sandbox keys

Can't Find Test Users

Test Users tab only appears in sandbox projects

Need More APIs

Complete verification for full API access in production

Webhook Issues

Sandbox webhooks work identically to production

​
Next Steps

You’ve mastered the sandbox! Time to level up:

Verify Identity

Complete KYB for production access

API Reference

Explore all available endpoints

Go Production

Create your first production project
Remember: Sandbox is your friend. Test everything here first. Break things, experiment, and learn. That’s what it’s for! When you’re confident everything works, production is just an endpoint change away.