🌐 Ambientes
🌐 Environments
Dos Ambientes Disponibles
Corresponsales API está disponible en dos ambientes: uno para pruebas y otro para producción.
Ambiente de Pruebas (Sandbox)
| Propiedad | Valor |
|---|---|
| Base URL | https://SANDBOX-DOMINIO (contacta a tu equipo de operaciones) |
| Propósito | Desarrollo, testing e integración inicial |
| Datos | Datos de prueba aislados (no afectan producción) |
| Disponibilidad | 99% SLA |
| Rate limit | 200 requests/hora (usuarios autenticados) |
| Retencion de datos | Se limpian cada semana |
| Certificado SSL | Auto-firmado (para desarrollo local) |
📌 Recomendación: Siempre comienza en sandbox. Utiliza este ambiente para validar tu
integración antes de pasar a producción.
Ambiente de Producción
| Propiedad | Valor |
|---|---|
| Base URL | https://PRODUCCION-DOMINIO (contacta a tu equipo de operaciones) |
| Propósito | Transacciones en vivo con datos reales |
| Datos | Datos completamente reales y vinculantes |
| Disponibilidad | 99.9% SLA |
| Rate limit | 200 requests/hora (usuarios autenticados) |
| Retencion de datos | Según políticas de auditoría y compliance |
| Certificado SSL | Válido emitido por Let's Encrypt |
⚠️ Importante: En producción, todo request genera transacciones reales. Verifica tu
integración en sandbox antes de enviar requests a producción.
Cómo Elegir el Ambiente
| Escenario | Ambiente | Razón |
|---|---|---|
| Desarrollo local | Sandbox (HTTP en localhost) | Datos aislados, sin riesgo a producción |
| Testing de integración | Sandbox | Valida flujos sin afectar datos reales |
| QA antes de release | Sandbox | Simula comportamiento sin comprometer reputación |
| Pruebas en producción (vivos) | Producción | Datos y transacciones reales. Usa con cuidado. |
| Transacciones comerciales | Producción | Única opción: datos reales para operaciones reales |
Cambiar Entre Ambientes
Para cambiar entre sandbox y producción, solo actualiza la base URL en tu código:
// Sandbox
const API_BASE = "https://SANDBOX-DOMINIO (contacta a tu equipo de operaciones)";
// Producción
const API_BASE = "https://PRODUCCION-DOMINIO (contacta a tu equipo de operaciones)";Todas las demás credenciales (JWT, API-key) se generan dentro de cada ambiente y no son intercambiables:
- Token de sandbox ≠ Token de producción
- API-key de sandbox ≠ API-key de producción
Monitoreo y Status
Consulta el estado de ambos ambientes:
- Estado del servicio: Contacta a tu equipo de operaciones
Two Available Environments
Corresponsales API is available in two environments: one for testing and one for production.
Testing Environment (Sandbox)
| Property | Value |
|---|---|
| Base URL | https://SANDBOX-DOMINIO (contacta a tu equipo de operaciones) |
| Purpose | Development, testing, and initial integration |
| Data | Isolated test data (doesn't affect production) |
| Availability | 99% SLA |
| Rate limit | 200 requests/hour (authenticated users) |
| Data retention | Cleaned weekly |
| SSL Certificate | Self-signed (for local development) |
📌 Recommendation: Always start in sandbox. Use this environment to validate your
integration before moving to production.
Production Environment
| Property | Value |
|---|---|
| Base URL | https://PRODUCCION-DOMINIO (contacta a tu equipo de operaciones) |
| Purpose | Live transactions with real data |
| Data | Completely real and binding data |
| Availability | 99.9% SLA |
| Rate limit | 200 requests/hour (authenticated users) |
| Data retention | Per audit and compliance policies |
| SSL Certificate | Valid certificate issued by Let's Encrypt |
⚠️ Important: In production, every request creates real transactions. Verify your
integration in sandbox before sending requests to production.
How to Choose the Environment
| Scenario | Environment | Reason |
|---|---|---|
| Local development | Sandbox (HTTP localhost) | Isolated data, no risk to production |
| Integration testing | Sandbox | Validates flows without affecting real data |
| QA before release | Sandbox | Simulates behavior without reputation risk |
| Live production testing | Production | Real data and transactions. Use with caution. |
| Commercial transactions | Production | Only option: real data for real operations |
Switching Between Environments
To switch between sandbox and production, just update the base URL in your code:
// Sandbox
const API_BASE = "https://SANDBOX-DOMINIO (contacta a tu equipo de operaciones)";
// Production
const API_BASE = "https://PRODUCCION-DOMINIO (contacta a tu equipo de operaciones)";All other credentials (JWT, API-key) are generated within each environment and are not interchangeable:
- Sandbox token ≠ Production token
- Sandbox API-key ≠ Production API-key
Monitoring and Status
Check the status of both environments:
- Estado del servicio: Contacta a tu equipo de operaciones