Pruebas
Uso de sandbox, pruebas de webhooks y checks de salida a producción para integraciones Cobru.
Empieza aquí
- Emite un access token en sandbox.
- Crea un pago real desde tu backend.
- Abre la URL hosted construida desde el
urlslug devuelto. - Confirma redirects y callback handling en tu propio sistema.
- Registra suficiente evidencia para poder depurar la corrida después.
Ambiente sandbox
| Propiedad | Valor |
|---|---|
| Base URL | https://dev.cobru.co |
| Propósito | desarrollo, QA, depuración de integración |
| Credenciales | separadas de producción |
| Fees | no representan economía real de producción |
| Uso recomendado | validación de auth, creación de pagos, checkout hosted, manejo de webhooks, pruebas QR/BRE-B |
Trata sandbox como un ambiente de validación de comportamiento, no como fuente de verdad para economía de producción, tiempos de settlement o procedimientos de soporte.
Flujo de prueba recomendado
- Emite un access token.
- Crea un pago en sandbox.
- Construye la URL hosted usando el
urlslug devuelto. - Completa el flujo manualmente en la página de Cobru.
- Confirma que tu webhook recibe el cambio de estado esperado.
Matriz mínima de pruebas
| Escenario | Qué verificar |
|---|---|
| refresh del token | POST /token/refresh/ funciona con tu estrategia de credenciales y caché |
| creación de pago | tu backend envía payment_method_enabled como string JSON y recibe 201 |
| URL hosted | tu app usa response.url, no response.pk, para construir el checkout |
| redirects | payer_redirect_url resuelve correctamente después del pago |
| callback handling | tu endpoint persiste, deduplica y responde rápido a callbacks |
| consulta/reconciliación | tu sistema puede reconciliar el pago después de callback o soporte manual |
Fixtures y cuentas recomendadas
- una orden de bajo valor para smoke tests
- una orden con BRE-B habilitado
- una orden con múltiples métodos de pago habilitados
- un fixture de payload inválido para confirmar normalización de errores
- un fixture de replay de webhook para verificar idempotencia
Pruebas locales de webhooks
ngrok http 3000Usa la URL HTTPS generada como tu campo callback en la request de creación de pago.
Qué registrar en cada corrida
- request body enviado a Cobru
- response body raw de Cobru
- URL de pago generada
- todos los payloads webhook
- tu propio resultado de conciliación
- el order ID interno o referencia de pago que mapeaste con Cobru
Errores comunes de sandbox
Criterios de salida antes de producción
- puedes crear y completar un pago end to end desde tu app
- puedes persistir y deduplicar callbacks
- puedes reconciliar manualmente un pago con datos Cobru y tu propio estado de orden
- tus logs incluyen suficiente información para depurar un pago fallido sin adivinar
- tus credenciales no están hardcodeadas fuera del almacenamiento seguro del servidor
Sigue con
/docs/production-readiness/docs/webhooks/docs/troubleshooting/docs/errors