Esta guía proporciona un enfoque general de testing para integraciones de Cobre, con casos de prueba recomendados divididos por Payin y Payout. Está diseñada para ayudarte a validar tanto flujos exitosos como escenarios de falla comunes, y para asegurar que tu integración se comporte correctamente en todos los entornos.Entorno QA / Sandbox#
El entorno de pruebas de Cobre actualmente está basado en un entorno QA. Para usar las APIs en QA, solicita credenciales QA (client_id y client_secret) a tu Account Manager.Dominio base (QA): https://api.qa.cobre.coDisponibilidad#
A continuación se muestra una tabla con los productos/soluciones que tienen un entorno QA, junto con algunos endpoints adicionales:| País / Solución | Disponible en QA |
|---|
| Colombia | true |
| México | false |
| Connect Account | false |
| Verificación de Cuenta | false |
| Cobre Keys | false |
| Checkout (CO) | true |
| Cross Border | false |
| Notificaciones | true |
| Evidence | false |
Cuando un producto no está disponible en QA — instancia de pruebas pre-Go Live#
Para los productos marcados como false arriba, Cobre despliega una instancia de pruebas pre-Go Live dedicada en lugar de QA, para dar soporte al desarrollo, testing y Aceptación de Usuario (UA) de ese producto.La instancia de pruebas pre-Go Live está completamente aislada de tu entorno productivo final: credenciales separadas (client_id/client_secret), usuarios de Portal separados y datos separados. No es QA, y no es tu instancia de producción en vivo.
Aislamiento de credenciales y datos — cuenta con sus propias credenciales, usuarios de Portal y datos, aislados tanto de QA como de la instancia en vivo eventual.
Confidencialidad y SLAs — los datos en la instancia de pruebas pre-Go Live se manejan bajo los mismos estándares de confidencialidad y enmascaramiento de datos, y los mismos SLAs de soporte, acordados para tu entorno de producción.
Transición al Go Live — una vez que estés listo para operar en vivo, Cobre despliega una instancia en vivo adicional y separada, con sus propias credenciales, usuarios de Portal y datos aislados. La instancia de pruebas pre-Go Live no se promueve ni se fusiona con ella.
Decomisionamiento — la instancia de pruebas pre-Go Live puede ser decomisionada a tu solicitud.
La instancia de pruebas pre-Go Live corre sobre infraestructura de grado productivo, pero es una cuenta separada de tu instancia de producción en vivo — credenciales separadas, datos separados. No trates la actividad de una como reflejo de la otra.
Matriz de disponibilidad (alto nivel)#
| Descripción | Endpoint | QA | Comentarios |
|---|
| Autenticación | /v1/auth | true | Es posible generar un token para QA |
| Cuentas | /v1/accounts | true | Es posible crear un Cobre Balance |
| Contrapartes | /v1/counterparties | true | Es posible crear una Contraparte |
| Agregar/Quitar fondos | /v1/account_test_transactions | true | Es posible agregar o quitar fondos de un Cobre Balance. |
| Descripción | Endpoint | QA | Comentarios |
|---|
| Movimiento de Dinero por Enlace Directo | /v1/money_movements | true | Solución de testing completa con rieles PSE y Bancolombia |
| Checkout | /v1/checkout | true | Es posible crear el Checkout. Solución de testing completa solo con riel Bancolombia |
Nequi y BreB no están disponibles.
| Descripción | Endpoint | Disponible en QA | Comentarios |
|---|
| Movimiento de Dinero | /v1/money_movements | true | Solución de testing completa |
| Cambiar Estado de PayOut | /v1/change_mm_state | true | Simular transiciones de estado a completed o rejected |
Se debe utilizar el código 1007 como entidad financiera de la contraparte, ya que es la única opción disponible.
Principios generales de testing#
Lo que debes validar en cada integración#
| Solución | Validaciones |
|---|
| Autenticación | Generación de token, Manejo de expiración, Estrategia de renovación |
| Creación de recursos | Creación de Cuentas y Contrapartes requeridas por tus flujos |
| Correctitud de Movimiento de Dinero | Combinaciones permitidas de source_id / destination_id, Monto en la menor unidad de moneda, Comportamiento de idempotencia, Manejo de errores y reintentos |
| Observabilidad | Consumo de webhooks y reconciliación vía recuperación de Movimientos de Dinero y reportes (si se usan) |
Tip: Siempre prueba tanto flujos Exitosos como Fallidos, usando el diccionario de errores para interpretar las fallas.
