Environments

Rise B2B API provides two environments for your integration needs: staging for testing and production for live operations.

Staging Environment

Use for testing and development

Production Environment

Use for live operations

SDK Environment Configuration

The Rise SDK uses the environment field to determine which API endpoints to use. By default, it uses production, but you can change it to staging for testing.

Environment Field Options

const { RiseApiClient } = require('@riseworks/riseworks-sdk');

// Production (default) - no environment field needed
const prodClient = new RiseApiClient({
  riseIdAuth: {
    riseId: process.env.RISE_ID,
    privateKey: process.env.WALLET_PRIVATE_KEY
  }
});

// Staging - explicitly set environment to 'stg'
const stagingClient = new RiseApiClient({
  environment: 'stg',  // This changes the API base URL to staging
  riseIdAuth: {
    riseId: process.env.RISE_ID,
    privateKey: process.env.WALLET_PRIVATE_KEY
  }
});

Environment Field Values

Value	API Base URL	Use Case
`'prod'` (default)	`https://integrations-api.riseworks.io`	Live operations
`'stg'`	`https://integrations-api.staging-riseworks.io`	Testing and development
`undefined`	`https://integrations-api.riseworks.io`	Same as ‘prod’

Changing Environment at Runtime

You can also change the environment after creating the client:

const client = new RiseApiClient({
  environment: 'stg',  // Start with staging
  riseIdAuth: {
    riseId: process.env.RISE_ID,
    privateKey: process.env.WALLET_PRIVATE_KEY
  }
});

// Later, switch to production
client.updateEnvironment('prod');

// Check current environment
console.log('Current environment:', client.getEnvironment()); // 'prod'

Important: Never use production credentials in staging environment, and never use staging credentials in production. Each environment has separate data and should be treated independently.

B2B API access is enabled per environment. Being enabled in staging does not enable you in production, so request each one you need. See Getting API Access.

Support

Error Handling

Troubleshooting environment issues

Support Email

Get help with environment setup

Need help with environment setup? Contact our support team if you have questions about configuring your integration for staging or production environments.

Platform Concepts

Security

Environments

Environments

Staging Environment

Production Environment

SDK Environment Configuration

Environment Field Options

Environment Field Values

Changing Environment at Runtime

Support

Error Handling

Support Email

​Environments

Staging Environment

Production Environment

​SDK Environment Configuration

​Environment Field Options

​Environment Field Values

​Changing Environment at Runtime

​Support

Error Handling

Support Email

Environments

SDK Environment Configuration

Environment Field Options

Environment Field Values

Changing Environment at Runtime

Support