Explorar las APIs con Postman

Use las colecciones oficiales de Postman de Cobre para explorar y probar la API de extremo a extremo — desde la autenticación hasta mover dinero por nuestros rieles locales y cross-border — sin escribir código primero.

Las colecciones viven en un workspace público de Postman. Impórtelas, cargue sus credenciales y envíe su primera solicitud en un par de minutos.

🔗 Abrir el workspace Cobre API en Postman

Qué incluye

Una colección General (Getting Started) con los bloques compartidos por todos los productos — Authentication, Cobre Balance, Counterparties, Webhooks y Reports — más una colección por producto:

Collection	Qué cubre
General (Getting Started)	Authentication, Cobre Balance, Counterparties, Webhooks, Reports. Empiece aquí.
PayIn — Colombia	Recaudar pagos en Colombia (Nequi, PSE, R2P, Checkout, Direct Debit).
PayIn — Mexico	Recaudar pagos en México (SPEI in, refunds).
PayIn — Global	Recaudar pagos internacionales hacia sus Cobre balances.
PayOut — Colombia	Enviar payouts en Colombia (ACH / Fast Pay, Bre-B).
PayOut — Mexico	Enviar payouts en México (SPEI out).
PayOut — Global	Enviar payouts a counterparties internacionales.
Cross-Border (USD/COP)	Cotizaciones FX y money movements cross-border.

La autenticación se comparte entre colecciones: autentíquese una vez y cada solicitud reutiliza el token.

Prerrequisitos

Requisito	Para qué
Una cuenta Cobre con credenciales de API (`client_id` y `secret`)	Necesarias para autenticarse. Pídaselas a su Key Account Manager si no las tiene.
Postman (app de escritorio o web)	Para importar y ejecutar las colecciones.

1. Abra el workspace

Abra el workspace Cobre API en Postman y haga fork de las colecciones a su propio workspace. El fork mantiene su copia sincronizada con las actualizaciones futuras de Cobre.

2. Configure su environment

El workspace incluye un environment con todas las variables que las solicitudes necesitan.

Seleccione el environment Cobre (selector de la esquina superior derecha).

Complete:

CobreBaseURL

https://api.cobre.co → Production

https://api.qa.cobre.co → QA / Sandbox

client_id → su client ID

secret → su secret

Deje access_token vacío — se asigna automáticamente cuando se autentica.

Guarde su client_id y secret en su propio environment privado. Nunca comparta un environment que contenga credenciales reales.

3. Autentíquese

Abra General → Authentication y haga clic en Send.

Su access token se guarda automáticamente en access_token.

El resto de solicitudes reutilizan ese token — no necesita autenticarse por cada colección.

Si una solicitud devuelve 401 Unauthorized, vuelva a ejecutar Authentication e intente de nuevo.

4. Envíe su primera solicitud

Un buen primer flujo:

General → Cobre Balance → Create — crea un balance contra el cual operar.

General → Counterparties → Create — registra a quién pagará o de quién recaudará.

Abra la colección del producto que necesita (p. ej. PayIn — Colombia) y envíe un money movement.

Bueno saber

Idempotency. Las solicitudes POST que crean recursos aceptan un header idempotency (mínimo 9 caracteres). Envíe un valor único por operación para reintentar de forma segura sin crear duplicados.

Base URL. Todas las solicitudes apuntan a {{CobreBaseURL}}, así puede cambiar de environment sin editar las solicitudes.

Webhooks. Use General → Webhooks para suscribirse a eventos y seguir el ciclo de vida de sus money movements.

Guías relacionadas

Cómo integrarse con Cobre — recorrido del cliente desde pre-sales hasta go-live

Construye con AI — conectar el MCP de Cobre Docs en su IDE

Generar código con MCP — generar código a partir de la spec en vivo

Explorar ejemplos de flujos de API — recorridos interactivos de las secuencias de la API de Cobre

Explorar las APIs con Postman

Qué incluye#

Prerrequisitos#

1. Abra el workspace#

2. Configure su environment#

3. Autentíquese#

4. Envíe su primera solicitud#

Bueno saber#

Guías relacionadas#

Qué incluye

Prerrequisitos

1. Abra el workspace

2. Configure su environment

3. Autentíquese

4. Envíe su primera solicitud

Bueno saber

Guías relacionadas