Envia.com test environment

The Envia.com test environment is a safe space where you can try all platform features without affecting your real operations. It is ideal for getting familiar with the system before you start shipping packages with real money.

What is it for?

• Test quoting, generating, and canceling labels at no extra cost.
• Connect and verify your ecommerce stores before activating them in production.
• Let your staff practice and learn the platform.
• Make sure everything works correctly before you launch your operations.

Differences between the test environment and production

Test environment	Production environment
Fictitious data	Real data
No real costs	Charges to your balance
For experimentation	For real operations

Note

The test environment does not affect your real balance or generate charges to your accounts.

Access the test environment

1. Sign in to your Envia.com account

2. In the side menu, click Developers > Test environment.

3. A new tab will open at accounts-sandbox.envia.com with the test environment sign-in screen.

4. Create your test account with a new user and password, or sign in if you already have one.

5. Once inside, you will be at shipping-test.envia.com, the test environment dashboard.

   Note

   Your production account credentials do not work in the test environment. Even if you access from your real account, you must register separately.

Get the API token for tests

If you are going to test the Envia API integration, you need to generate a specific token inside the test environment.

1. Sign in to **shipping-test.envia.com** (your test account).

2. Go to Developers > API access.

3. Click Add to generate a new token.

4. Copy the token and use it in your calls to the sandbox endpoints.

   Note

   Use this token only with the sandbox URLs. If you use it with production URLs, you will receive an authentication error, and vice versa.

Test environment limitations

The sandbox replicates the production experience, but with some important differences:

• Labels generated are not real and do not have tracking with carriers.
• Payments and balance top-ups are not processed; sandbox balance is fictitious.
• Some carrier integrations may behave differently or not be available in tests.
• Sandbox data (addresses, packages, history) is independent and is not synced with your production account.

Move to production

When you have validated your flows in the sandbox, the next step is to operate in production.

1. Sign in to your production account at shipping.envia.com.

2. If you need an API token, generate it in Developers > API access from your production account.

3. If you have an API integration, replace the URLs.

4. Replace the sandbox token with the production token.

   Note

   Make sure your production account is verified before generating real labels. See the Verify your account article if you have pending steps.

Frequently asked questions

Can I use my production account to run tests? It is not recommended. Labels generated in production are real and generate charges. Always use the sandbox for testing and development.

Is the balance I have in production available in the sandbox? No. Balance, addresses, packages, and history are completely independent between both environments.

Do I need to verify my account in the sandbox? No. In the test environment you can operate without going through the identity verification process that applies in production.

Are the carriers available in sandbox the same as in production? For the most part yes, although some carriers may have limited availability or different behavior in the test environment.

Can I have access to the sandbox and production at the same time? Yes. They are independent accounts and you can have an active session in both from different browsers or tabs.

Is using the test environment mandatory? No, but we recommend it to reduce errors before operating in production, especially if you are going to connect an ecommerce store or integrate the API.