​
What is the Sandbox Environment?

The sandbox is a complete clone of your xPay account that operates in an isolated testing environment. It provides:
  • Identical Features: Most production features are available for testing
  • Safe Testing: No real money is processed, no real customers are affected
  • Full Functionality: Test payments, subscriptions, refunds, and most API endpoints

​
Sandbox API Endpoint

Sandbox Endpoint: https://api.test.xpaycheckout.com

​
Sandbox Dashboard Access

Once you have sandbox access, you can access your sandbox environment at: Sandbox Dashboard: https://app.test.xpaycheckout.com/

​
Getting Sandbox Access

1

Contact xPay Support

Reach out to our support team to request sandbox access for your account. You can contact us through the dashboard or via email.
2

Account Verification

Our team will verify your account and prepare your sandbox environment with a complete clone of your production settings.
3

Receive Sandbox Credentials

You’ll receive:
  • Sandbox Email: Login email for the sandbox dashboard
  • Sandbox Password: Secure password for sandbox access

​
Sandbox API Keys

Your sandbox environment comes with dedicated API keys that are separate from your production keys. You can generate your sandbox API keys directly from the sandbox dashboard. For detailed instructions on how to obtain your API keys, see our Get Your Keys guide.
Never use sandbox keys in production or production keys in sandbox.
Always ensure you’re using the correct set of keys for the environment you’re working in.

​
Switching Between Environments

1

Development Phase

Use sandbox environment with sandbox API keys for all development and testing.
2

Production Deployment

Switch to production environment with live API keys only when ready for real transactions.
3

Environment Variables

Use environment variables to manage different API keys:
# Sandbox
XPAY_PUBLIC_KEY=your_sandbox_public_key
XPAY_PRIVATE_KEY=your_sandbox_private_key
XPAY_BASE_URL=https://api.test.xpaycheckout.com

# Production
XPAY_PUBLIC_KEY=your_live_public_key
XPAY_PRIVATE_KEY=your_live_private_key
XPAY_BASE_URL=https://api.xpaycheckout.com
Sandbox data may be periodically reset to ensure a clean testing environment. Any test data you create may be cleared during these resets.
Remember: The sandbox environment is for testing only. Never process real payments or use real customer data in the sandbox environment.