Test Using Sandbox Credentials

Safely test your integration without real transactions

OZZOBiT provides a sandbox environment that allows you to test your entire integration flow without processing real payments or moving actual cryptocurrency. Use sandbox credentials during development and testing before switching to production.

Getting Sandbox Credentials

Access Sandbox Settings

In your Partner Dashboard, navigate to Settings → Environment and switch to "Staging/Sandbox" mode.

Get Sandbox API Keys

Sandbox uses separate API keys from production. Your dashboard will show sandbox-specific keys when in staging mode:

config.jsjavascript

// Sandbox (Staging) Configuration
const SANDBOX_CONFIG = {
  apiKey: 'sandbox-public-key-xxxxx',    // Your sandbox public key
  environment: 'STAGING',                 // Must be STAGING for sandbox
  hostURL: 'https://staging-OZZOBiT.com/api',
}

// Production Configuration (for reference - don't use both!)
const PROD_CONFIG = {
  apiKey: 'prod-public-key-xxxxx',       // Your production public key
  environment: 'PRODUCTION',              // Must be PRODUCTION for live
}

Use Test Wallet Addresses

Sandbox accepts any valid wallet address format but does not actually send crypto. You can use test addresses like:

javascriptjavascript

// Valid test wallet addresses (format only, no real transfers)
const TEST_WALLETS = {
  ethereum: '0x742d35Cc6634C0532925a3b844Bc9e7595f8bD21',
  polygon: '0x742d35Cc6634C0532925a3b844Bc9e7595f8bD21',
  bsc: '0x742d35Cc6634C0532925a3b844Bc9e7595f8bD21',
}

Sandbox Behavior

Feature	Sandbox Behavior
Payments	No real charges; all payment methods simulate success
Crypto Transfers	No on-chain transactions occur
KYC Verification	Auto-approved or configurable delay
Order Status	Orders progress through full lifecycle for testing
Webhooks	Webhooks are sent to your configured endpoints
Quotes/Prices	Uses realistic but simulated pricing data
Emails	Test emails may or may not be sent depending on config
Rate Limits	More generous rate limits than production

ℹ️

Testing Checklist

Test widget initialization with your sandbox apiKey
Verify order creation flows (on-ramp, off-ramp, NFT)
Test webhook delivery and payload parsing
Test error scenarios (failed payments, KYC rejection)
Verify redirect URL handling with status parameters
Test event handling in SDK integrations
Validate API error responses and retry logic

Switching to Production

When you're ready to go live:

Switch environment from STAGING to PRODUCTION
Replace sandbox API keys with production keys
Update webhook URLs if using different endpoints
Remove any test/hardcoded data
Start with small transaction amounts for initial live tests
Monitor your first transactions closely in the dashboard

⚠️

Never Use Production Keys in Sandbox

Production API keys will not work in the sandbox environment, and vice versa. Always ensure you're using the correct keys for each environment.