Preparación para producción
Checklist operativo para llevar una integración Cobru desde sandbox a tráfico real.
Salir a producción con Cobru no es solo cambiar credenciales. Trata la preparación para producción como un hito operativo con checks explícitos sobre auth, creación de pagos, callbacks, observabilidad y soporte.
Empieza aquí
- Confirma credenciales de producción, callback URL y estrategia de logging.
- Ensaya un pago end to end con conciliación manual.
- Verifica que soporte pueda rastrear un pago desde tu order ID interno hasta los objetos Cobru.
- Define criterios de rollback antes de abrir tráfico amplio.
Checklist de go-live
Confirma que las credenciales de producción se guardan solo en configuración segura del servidor y no se comparten con frontend.
Cambia la base URL a https://prod.cobru.co solo después de pasar flujos consistentes en sandbox.
Confirma que tu callback URL es pública, HTTPS, monitoreada e idempotente.
Valida que el equipo puede reconciliar manualmente un pago desde request hasta callback y estado interno.
Asegura que soporte puede ubicar pagos por order ID interno y por slug url de Cobru.
Controles mínimos antes de tráfico real
| Área | Requisito |
|---|---|
| Auth | caché de access token y almacenamiento seguro de secretos |
| Payments | serialización segura de payment_method_enabled y redirects confiables |
| Webhooks | respuesta 200 rápida, persistencia, deduplicación y reconciliación |
| Logging | request IDs, responses raw de Cobru y logs de eventos webhook |
| Support | capacidad de trazar un pago desde la orden interna hasta el objeto Cobru |
| Monitoring | alertas sobre fallas al crear pagos y al procesar webhooks |
Estrategia recomendada de lanzamiento
- empieza con tráfico interno o de bajo riesgo
- mantén conciliación manual durante los primeros días
- evita comunicación amplia a clientes hasta confirmar estabilidad de callbacks
- documenta ownership de incident response para la semana de lanzamiento
Áreas sensibles en producción
Criterios de rollback del día de salida
Pausa o limita tráfico real si:
- cae inesperadamente el success rate de creación de pagos
- dejan de llegar callbacks o no puedes reconciliarlos
- no puedes empatar pagos Cobru con órdenes internas de forma confiable
- soporte no puede diagnosticar fallas con la información disponible
Sigue con
/docs/testing/docs/webhooks/docs/errors/docs/troubleshooting