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 |
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 |
Nequi y contrapartes tipo wallet no están soportadas.
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.
Modified at 2026-02-11 17:18:40
