Primeros pasos
Mapa de integración de Cobru para aceptar pagos, mover saldo, operar tesorería y consultar la referencia API.
Cobru es una plataforma de pagos colombiana para equipos que necesitan lanzar links de pago hosted, soportar métodos locales, automatizar cobranzas y operar movimiento de dinero desde una sola API.
Esta documentación está organizada por flujos de producto. Usa esta página como mapa inicial: empieza por credenciales, sigue por el flujo que quieres construir y usa la referencia API cuando necesites payloads exactos.
Elige un camino
Quickstart
Obtén un access token, crea tu primer payment link y valida el camino mínimo.
Autenticación
Entiende credenciales, bearer tokens, refresh y manejo seguro de sesiones.
Cobros
Crea Cobrus hosted y activa métodos como PSE, Nequi, Bre-B, Bancolombia y tarjeta.
Envíos y retiros
Mueve saldo con envíos, retiros bancarios, retiros en efectivo y flujos Bre-B.
Balances y movimientos
Consulta balances, movimientos y señales operativas para conciliación.
Tarjetas
Revisa emisión, detalle, movimientos, congelamiento y recarga de tarjetas virtuales.
Servicios
Explora recargas, Pines y otros servicios transaccionales expuestos por Cobru.
Webhooks
Procesa cambios de estado asíncronos, retries y eventos relevantes para conciliación.
Referencia API
Abre el contrato OpenAPI interactivo para request y response shapes exactos.
Qué leer primero
- Inicio rápido para crear el primer payment link.
- Autenticación para endurecer el manejo de tokens.
- Cobrus para aceptar pagos con métodos locales.
- Envíos y retiros si tu integración mueve saldo fuera del checkout.
- Webhooks, Testing y Preparación para producción antes del go-live.
- Referencia API cuando necesites request y response shapes exactos.
Superficie de producto
| Área | Para qué la usa un developer |
|---|---|
| Cobros | Crear Cobrus hosted, calcular fees, inspeccionar detalles de pago y manejar métodos locales |
| Envíos y retiros | Mover saldo, ejecutar retiros en efectivo, retiros bancarios y flujos de settlement Bre-B |
| Balances y movimientos | Consultar balances, movimientos y evidencia para conciliación |
| Tarjetas y servicios | Operar tarjetas, recargas, Pines y otras APIs visibles del producto |
Ambientes
| Ambiente | URL base |
|---|---|
| Sandbox | https://dev.cobru.co |
| Producción | https://prod.cobru.co |
Verificación y soporte
| Fuente | Rol |
|---|---|
sandbox dev.cobru.co | Fuente principal para verificar comportamiento real |
| materiales API históricos de Cobru | Fuente secundaria para endpoints aún no revalidados |
| capturas del menú API de Cobru | Fuente de alcance para familias pendientes de extracción de contrato |
soporte@cobru.co | Ruta de escalación cuando un contrato debe confirmarse antes de producción |