Environments

Supported Environments

The PayNext SDK supports different environments for development, testing, and production use: sandbox
production

Environment Configuration

Configure your environment when initializing the PayNext SDK:

Set the environment property on the object you pass into checkout.mount('element-id', { ...config }) after creating the instance with new PayNextCheckout(), following Mount the Checkout.

custom component

import { type PayNextConfig } from '@paynext/sdk'

const sandboxConfig: PayNextConfig = {
  environment: 'sandbox',
  /* other options */
}

// When mounting (see Getting Started "Mount the Checkout" section):
// const checkout = new PayNextCheckout()
// await checkout.mount('checkout-container', sandboxConfig)

Refer to Mount the Checkout for the complete mounting flow.

Environment Details

Sandbox

Testing environment that mimics production behavior without processing real payments.Characteristics:

Realistic payment flows
Test card numbers supported
Full API feature parity
Safe for integration testing
No actual charges

Use cases:

Integration testing
QA validation
Demo environments
Client presentations
Pre-production testing

sandbox-config component

import { type PayNextConfig } from '@paynext/sdk'

const sandboxConfig: PayNextConfig = {
  environment: 'sandbox',
  clientToken: 'sandbox_client_token_here',
  /* other options */
}

// When mounting (see Getting Started "Mount the Checkout" section):
// const checkout = new PayNextCheckout()
// await checkout.mount('checkout-container', sandboxConfig)

Refer to Mount the Checkout for the complete mounting flow.

Sandbox is the recommended environment for testing and development.

Production

Live production environment that processes real payments with actual money.Characteristics:

Real payment processing
Live card transactions
Production security standards
Actual money movement
Full compliance requirements

Use cases:

Live customer transactions
Production applications
Real e-commerce
Revenue generation

production-config component

import { type PayNextConfig } from '@paynext/sdk'

const productionConfig: PayNextConfig = {
  environment: 'production',
  clientToken: 'live_client_token_here',
  /* other options */
}

// When mounting (see Getting Started "Mount the Checkout" section):
// const checkout = new PayNextCheckout()
// await checkout.mount('checkout-container', productionConfig)

Refer to Mount the Checkout for the complete mounting flow.

Production environment processes real payments. Ensure thorough testing in sandbox first.

Production Considerations

Never use test card numbers in a production environment. Only real payment methods work in production.

Environment URLs

Each environment connects to different API endpoints:

Sandbox

API Endpoint: api-sandbox.paynext.com
Dashboard: sandbox-dashboard.paynext.com

Production

API Endpoint: api.paynext.com
Dashboard: dashboard.paynext.com

Environment Security

Different API keys are required for each environment:

api-keys component

// Server-side secret keys (never expose to client)
const secretKeys = {
  sandbox: 'edccag94-8fa4-44ft-ft03-fdd818d23c05',
  production: 'idhhyf83-9go7-77gr-gr70-crr646f67e69'
}

Client tokens are safe to use in frontend code. Secret keys must only be used server-side.

Environment Migration Checklist

Sandbox → Production

Update the environment to production
Replace the sandbox client token with production
Remove test card usage
Configure production webhooks
Set up production monitoring
Verify merchant account settings
Conduct final testing with small amounts
Monitor initial production transactions

Use environment-specific domains and subdomains to clearly distinguish between environments and prevent accidental cross-environment usage.

Getting Started

Use Cases

Customization

Constants

Supported Environments

Environment Configuration

Environment Details

Production Considerations

Environment URLs

Sandbox

Production

Environment Security

Environment Migration Checklist

​Supported Environments

​Environment Configuration

​Environment Details

​Production Considerations

​Environment URLs

Sandbox

Production

​Environment Security

​Environment Migration Checklist

Supported Environments

Environment Configuration

Environment Details

Production Considerations

Environment URLs

Environment Security

Environment Migration Checklist