Move from Sandbox to Live

Move to Live only after Sandbox tests pass and Voyced has enabled Live access for your integration.

Protect your Voyced access from the first test

Your API credentials can access customer information and the functions allowed for that key. Treat the API secret like a password. Store it only in protected server-side settings or a trusted secret store.

  • Never put an API key, API secret or bearer token in public code, browser JavaScript, screenshots, URLs or support messages.
  • Keep Sandbox and Live credentials separate. Give each integration only the permissions it needs.
  • Rotate the secret and disable the old key at once when exposure is suspected.
Read the security checklist
Start here

Sandbox

https://sandbox.voycedconnect.eu/v1

Build and check your integration without using Live credentials.

After approval

Live

https://api.voycedconnect.eu/v1

Use only after your tests pass and Voyced has enabled Live access.

Sandbox credentials do not work in Live
Voyced supplies separate Live credentials. A Sandbox API key, API secret or bearer token cannot be reused against the Live URL.
Change configuration, not your API logic
Keep the same endpoint paths and request format. Change the base URL and use the separate Live credentials supplied by Voyced. Then request a new Live bearer token and repeat the connection checks.

Change exactly these values

1

Base URL

Change Sandbox to https://api.voycedconnect.eu/v1.

2

API key and secret

Replace both Sandbox values with the separate Live values supplied by Voyced.

3

Bearer token

Request a new token from Live. Never copy a Sandbox token.

What changes

SettingSandboxLive
Base URLhttps://sandbox.voycedconnect.eu/v1https://api.voycedconnect.eu/v1
API keySandbox keySeparate Live key supplied by Voyced
API secretSandbox secretSeparate Live secret supplied by Voyced
Bearer tokenRequested from SandboxRequest a new token from Live
PermissionsSandbox permissionsMay differ. Check capabilities again.
DataSandbox accessLive customer information

What stays the same

  • The /v1 path
  • Endpoint paths
  • Request and response formats
  • Bearer-token header format
  • Error structure and request IDs

Use environment settings

Do not hard-code the URL or credentials. Keep Sandbox and Live settings separate.

Environment settings
# Sandbox
VOYCED_API_BASE_URL=https://sandbox.voycedconnect.eu/v1
VOYCED_API_KEY=YOUR_SANDBOX_API_KEY
VOYCED_API_SECRET=YOUR_SANDBOX_API_SECRET

# Live, use only after approval
VOYCED_API_BASE_URL=https://api.voycedconnect.eu/v1
VOYCED_API_KEY=YOUR_LIVE_API_KEY
VOYCED_API_SECRET=YOUR_LIVE_API_SECRET

Go-live process

1

Complete Sandbox testing

Test the full workflow, including failures, retries and token renewal.

2

Request Live access from Voyced

Provide the integration purpose, required permissions and expected request volume.

3

Store the Live credentials separately

Never overwrite or copy Sandbox credentials into the Live configuration.

4

Request a Live bearer token

Use the Live key and secret with https://api.voycedconnect.eu/v1/auth/token.

5

Run Live checks

Run the connection test and capabilities endpoint before enabling the complete workflow.

6

Start with controlled traffic

Watch API responses, request IDs, rate limits and the Voyced status page.

First Live smoke tests

After you receive a Live bearer token, run these two read-only checks before starting the full workflow.

Connection test
curl --request GET \
  --url 'https://api.voycedconnect.eu/v1/test' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_LIVE_BEARER_TOKEN'
Capabilities
curl --request GET \
  --url 'https://api.voycedconnect.eu/v1/capabilities' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_LIVE_BEARER_TOKEN'
  1. Keep the tested Sandbox setup unchanged.
  2. Enable Live for a small, controlled test first.
  3. Check the Live request IDs, responses and workflow logs.
  4. Increase normal traffic only after the smoke tests pass.
  5. When a Live test fails, stop the Live workflow and return to the unchanged Sandbox copy while you correct it.

Safe activation and rollback

Do not enable scheduled jobs or high request volumes until both checks succeed and the required Live permissions are available.

Live credentials authorise real account access
Use a dedicated Live key with only the permissions the integration needs. Limit who can view or change it, and keep a tested method to disable the workflow quickly.

Final checklist