🇺🇸 EnglishIntroductionEnvironments

Environments

Colurs provides two environments: Sandbox for development and testing, and Production for real operations.


Comparison

FeatureSandboxProduction
Base URLhttps://dev.backend.colurs.cohttps://prod.colurs.co
Real transactions❌ No✅ Yes
CredentialsDevelopment API keyProduction API key
DataMock / test dataReal data

Sandbox

Safe environment to develop and test your integration without risk.

⚠️

Sandbox does not process real money. Use it to validate all your flows before moving to production.

How to access:

  1. Request your Sandbox credentials through this channel. Click Here
  2. Use https://dev.backend.colurs.co as base URL in all requests
  3. Include your development API key in x-api-key header

Production

Real environment where operations with real money are processed.

To access Production, you must complete business onboarding with the Colurs team. Book a demo.


Checklist before going to Production

  • All flows tested and validated in Sandbox
  • Error handling implemented for 400, 401, 403, and 500 codes
  • Automatic access_token refresh implemented in your client
  • Webhook handlers configured to receive platform events
  • Production credentials requested and received
  • Base URL updated to https://prod.colurs.co
  • Environment variables configured (do not hardcode API keys)

Required headers in both environments

Content-Type: application/json
Accept: application/json
x-api-key: TU_API_KEY
Authorization: Bearer TU_ACCESS_TOKEN

💡

Tip: Use an environment variable COLURS_BASE_URL ##to## switch lol Sandbox and Production with a single configuration change.

💡

Tip: Use an environment variable COLURS_BASE_URL ++‘to’++ switch between estas son las validaciones de credenciales