Skip to main content
Antes de procesar transacciones reales, tu integración debe ser certificada por Cobrix.

​
Proceso de Certificación

​
Checklist de Certificación

Antes de solicitar la certificación, verifica que cumples con todos los requisitos:

​
Integración Técnica

Flujo completo de checkout implementado (5 pasos)
Verificación de firma HMAC en webhooks
Manejo de idempotencia en webhooks
Endpoint de webhook con HTTPS
Manejo correcto de errores y reintentos
Logs de webhooks implementados

​
Pruebas en Sandbox

Pago exitoso con Débito Inmediato
Pago exitoso con Pago Móvil
Pago exitoso con Zelle (si aplica)
Manejo de pago fallido
Manejo de sesión expirada
Webhook recibido y procesado correctamente

​
Seguridad

Access Token almacenado como variable de entorno
Webhook Secret almacenado de forma segura
No hay credenciales en código fuente o logs
HTTPS en todos los endpoints

​
Experiencia de Usuario

Redirección correcta tras pago exitoso
Redirección correcta si usuario cancela
Mensajes de error claros
Estado de orden actualizado tras webhook

​
Datos de Prueba - Pago Móvil

Usa estos datos en Sandbox para probar diferentes escenarios:

​
Pago Móvil Aceptado

CampoValor
Banco0001 (Banco Central de Venezuela)
Teléfono4145223698
CédulaV15854963
OTP12345678

​
Pago Móvil Rechazado

CampoValor
Banco0001 (Banco Central de Venezuela)
Teléfono4121234597
CédulaV12345708
OTP12345678

​
Pago Móvil Pendiente

CampoValor
CédulaV8866332211
Teléfono4227786632
OTP12345678

​
Escenarios de Prueba

EscenarioDatos a UsarResultado Esperado
Pago exitosoDatos “Aceptado”payment.succeeded
Pago fallidoDatos “Rechazado”payment.failed
Pago pendienteDatos “Pendiente”Estado pending
Sesión expiradaEsperar timeoutcheckout.session.expired
Usuario cancelaClick en “Cancelar”Redirect a cancelUrl

​
Solicitar Certificación

​
Paso 1: Completar Checklist

Asegúrate de cumplir todos los puntos del checklist anterior.

​
Paso 2: Documentar la Integración

Prepara un documento con:
  • Diagrama de flujo de tu integración
  • Endpoints implementados
  • Cómo manejas cada tipo de webhook
  • URLs de tu aplicación (staging/producción)

​
Paso 3: Enviar Solicitud

Envía un email a [email protected] con: 
Asunto: Solicitud de Certificación - [Nombre de tu Empresa]

Contenido:
- Company ID de Sandbox
- Documentación de la integración
- URLs de staging para revisión
- Contacto técnico

​
Paso 4: Revisión Técnica

El equipo de Cobrix:
  1. Revisará tu implementación
  2. Ejecutará pruebas automatizadas
  3. Verificará el manejo de webhooks
  4. Validará la seguridad

​
Paso 5: Feedback

Recibirás feedback que puede incluir:
  • ✅ Aprobado: Recibes credenciales de producción
  • 🔄 Cambios requeridos: Lista de ajustes necesarios

​
Tiempo Estimado

FaseDuración
Revisión inicial1-2 días hábiles
Feedback1 día hábil
Re-revisión (si aplica)1-2 días hábiles
Total típico3-5 días hábiles

​
Después de la Certificación

​
Credenciales de Producción

Recibirás:
CredencialPrefijo
Company IDcompany_live_...
Access Token(JWT token)
Webhook Secretwhsec_live_...

​
Actualizar Configuración

# .env.production
COBRIX_ACCESS_TOKEN=tu_access_token_produccion
COBRIX_COMPANY_ID=company_live_tu_company_id
COBRIX_WEBHOOK_SECRET=whsec_live_tu_secret
COBRIX_BASE_URL=http://api.cobrix.co/api

​
Deploy

1

Configurar variables

Actualiza las variables de entorno en tu servidor de producción
2

Actualizar webhook URL

Configura tu URL de webhook de producción en el panel de Cobrix
3

Verificar conectividad

Prueba que tu servidor puede comunicarse con la API de producción
4

Monitorear

Activa alertas para errores de webhook y pagos fallidos

​
Soporte Post-Certificación

Una vez en producción tienes acceso a:
RecursoDescripción
Soporte prioritarioRespuesta en < 4 horas hábiles
Panel de monitoreoDashboard de transacciones
AlertasNotificaciones de errores
Account ManagerContacto dedicado

​
Preguntas Frecuentes

Sí, solo necesitas cambiar las variables de entorno (API Key, Company ID, URLs base).
Recibirás feedback específico sobre los cambios requeridos. Una vez implementados, puedes solicitar re-revisión.
Sí, pero cambios significativos en el flujo de pagos pueden requerir re-certificación.
No, la certificación está incluida en el servicio de Cobrix.