Skip to main content

Sandbox vs Production

Cheqpay provides two separate environments to help you develop and test your integration safely before going live.

Sandbox Environment

Use sandbox to test your integration without processing real money or affecting live data.

Features

  • Test your integration without real money
  • Use test cards and SPEI accounts
  • Perfect for development and testing
  • Faster processing for testing
  • Full feature parity with production

Base URL

https://api.cheqpay.dev

When to Use Sandbox

Development

Build and test your integration locally

Testing

Run automated tests and QA workflows

Demos

Show product demos to stakeholders

Training

Train your team on the platform

Test Data

In sandbox, you can use:
  • Test card numbers (see Testing Guide)
  • Mock SPEI transfers (auto-complete after 30 seconds)
  • Simulated webhook events
  • Test 3D Secure flows
Refunds process instantly in sandbox instead of taking 5-10 days like in production.

Production Environment

Use production to process real payments with actual money and live customer data.

Features

  • Process real payments
  • Live API credentials required
  • Full compliance and security
  • Real bank integrations
  • Actual money movement

Base URL

https://prod.cheqpay.mx

Requirements

Before using production:
Submit your business documentation and complete KYC verification.
Contact support to receive your production API credentials.
Ensure your integration works perfectly before going live.
Set up your production webhook endpoints.

Switching Between Environments

Simply change the base URL and API key:
// Sandbox
const baseUrl = 'https://api.cheqpay.dev';
const apiKey = process.env.CHEQPAY_SANDBOX_KEY;

// Production
const baseUrl = 'https://prod.cheqpay.mx';
const apiKey = process.env.CHEQPAY_PRODUCTION_KEY;
Never use production API keys in sandbox or vice versa. Each environment requires its own credentials.

Going Live

Ready to switch to production? Follow our Going Live Guide for a complete checklist.

Go Live Checklist

Review all the steps needed to launch in production