Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cobrix.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Ambientes disponibles

Staging

Desarrollo y pruebas
  • Pagos simulados
  • Sin transacciones reales
  • API keys con prefijo sk_test_*

Producción

Transacciones reales
  • Requiere certificación
  • API keys con prefijo sk_live_*
  • SLA garantizado

​
URLs base

​
API

AmbienteURL base
Staginghttps://api-staging.cobrix.co
Producciónhttps://api.cobrix.co
El prefijo de todos los endpoints de pagos es /api/external/payments.

​
Checkout UI (modo Hosted)

AmbientePatrón
Staginghttps://checkout-staging.cobrix.co/checkout/{token}
Producciónhttps://checkout.cobrix.co/checkout/{token}
La URL exacta se devuelve en el campo checkoutUrl al crear un pago hosted.

​
Configuración recomendada

Usa variables de entorno para alternar entre ambientes: 
// config/cobrix.js
module.exports = {
  apiKey: process.env.COBRIX_API_KEY,
  baseUrl:
    process.env.NODE_ENV === 'production'
      ? 'https://api.cobrix.co'
      : 'https://api-staging.cobrix.co',
}

​
Variables de entorno

# Staging (.env.development)
COBRIX_API_KEY=sk_test_acme_...

# Producción (.env.production)
COBRIX_API_KEY=sk_live_acme_...
Las API keys de Staging y Producción son completamente diferentes. Una key sk_test_* no funciona contra api.cobrix.co, ni viceversa.

​
Diferencias entre ambientes

CaracterísticaStagingProducción
Transacciones reales❌✅
Webhooks✅✅
Métodos de pagoSimuladosReales
Rate limit por key60/min60/min (configurable)
SLANo garantizado99,9%

​
Ir a producción

1

Completar la integración

Verifica que todos los flujos funcionen en Staging.
2

Pasar certificación

Completa el proceso de certificación.
3

Recibir credenciales

Un admin de la empresa genera una key sk_live_* desde el dashboard.
4

Actualizar configuración

Cambia la variable COBRIX_API_KEY y la URL base en producción.