Cómo integrarse con Cobre

Esta es la vista del cliente de una integración con la API de Cobre: qué hace usted, qué espera y a quién preguntar. Su Key Account Manager (KAM) es el contacto comercial. Le indica el siguiente paso para su cuenta — incluido cómo se produce el Solution Design y quién lo acompaña durante la implementación.

Use el Kit de desarrollo en todo el proceso: Crear un Solution Design con IA, Construye con AI, Generar código con MCP y Explorar ejemplos de flujos de API.

El recorrido

Pre-sales → Integration → Certification / Go-live → Support

Etapa	Qué significa para usted
Pre-sales	Conversaciones comerciales y técnicas. Aún no construye contra el entorno de integración de Cobre.
Integration	Confirma el diseño que implementará; luego sus ingenieros construyen y prueban.
Certification / Go-live	Demuestra la integración y Cobre la certifica antes de producción.
Support	Su KAM sigue siendo el contacto. Presenta contactos adicionales de Cobre si aplica a su cuenta.

1. Pre-sales

Trabaje con su contacto comercial y su KAM. Actividades típicas: encaje de producto, propuesta, due diligence y discusión del contrato.

Su KAM comparte la documentación que necesita su equipo técnico — incluido este Kit de desarrollo. No necesita credenciales de producción todavía. Use Comenzar para conocer el modelo de la plataforma (Accounts, Counterparties, Money Movements).

2. Cuándo puede empezar la integración

El trabajo de integración empieza solo cuando se cumplen todas las condiciones siguientes. Su KAM las confirma — usted no necesita rastrear los sistemas internos de Cobre.

Su acuerdo comercial está en firma o ya firmado.

Hay un Key Account Manager asignado a su cuenta.

Cobre abrió un API onboarding para usted.

Hasta entonces, permanece en pre-sales. Si sus ingenieros están listos antes, dígaselo a su KAM — él indicará cuándo hay credenciales y entornos disponibles.

3. Integration

Siga la secuencia que defina su KAM. Un recorrido típico se ve así:

Alinearse con su KAM

Descripción: Según el volumen esperado de operación y la complejidad de la integración, su KAM puede agendar un kickoff técnico con su equipo y un Solution Engineer de Cobre.

Qué esperar después de la acción: Sabe quiénes son sus contactos en Cobre y qué sigue.

Confirmar el diseño que implementará

Descripción: También puede redactar un Solution Design con su propio equipo usando Crear un Solution Design con IA. Cobre documentará un Solution Design solo cuando el KAM decida involucrar a un Solution Engineer.

Qué esperar después de la acción: Sus equipos de Producto e Ingeniería tienen un diseño contra el cual implementar.

Iniciar el desarrollo

Descripción: Informe a su KAM de que el desarrollo comenzó. Solicite credenciales de QA cuando las necesite. Consulte Construir en QA.

Si el KAM identificó que el volumen esperado y la complejidad de la integración son significativos, su equipo puede tener acceso a un Integration Engineer de Cobre por Slack, grupos de WhatsApp o correo.

Qué esperar después de la acción: Su equipo implementa los flujos acordados en el entorno de pruebas de Cobre, donde esos productos estén disponibles.

4. Construir en QA

Solicite a su KAM las credenciales de QA (client_id y client_secret). Autentíquese como en Autenticación. El dominio base de QA es https://api.qa.cobre.co.

No todos los productos están disponibles en QA. Consulte Pruebas generales para la matriz vigente (por ejemplo, algunas superficies de México y Cross Border no están en QA). Use Casos de prueba para caminos felices y de fallo recomendados.

Mientras construye:

Necesidad	Use
Modelo de la plataforma	Comenzar e Inicio rápido
Especificación OpenAPI en vivo en su IDE	Construye con AI
Secuencias de API	Explorar ejemplos de flujos de API
Andamiaje a partir de la spec	Generar código con MCP
Preguntas ancladas en la documentación	Conecta la documentación de Cobre a la IA
Avisos de cambios de API y producto	Gestión de cambios en la API y productos

Actualice el MCP de Cobre Docs en el mismo chat antes de generar código o un Solution Design. No implemente de memoria ni desde una caché de spec antigua.

5. Certification y go-live

Cuando la integración esté lista para operar, solicite la certificación a través de su KAM (o de su Integration Engineer de contacto). Detalle completo: Proceso de Certificación.

Antes de la sesión:

Revise el Cuestionario y esté en capacidad de responderlo.

Prepare una demostración en vivo de los flujos que implementó.

La sesión cubre el cuestionario y una demostración en vivo contra el entorno QA o de producción de Cobre, según disponibilidad. Cobre emite luego un reporte de certificación (puntaje, feedback, issues, recomendaciones). Pasa a producción solo después de que la integración esté certificada, o después de cerrar los ajustes requeridos.

6. Después del go-live

Su KAM y el Integration Engineer siguen siendo los contactos para issues de producción, productos nuevos y comunicación de cambios de API. Su KAM le dirá si contactos adicionales de Cobre permanecen involucrados después del go-live.

Siga Gestión de cambios en la API y productos para que su implementación se mantenga alineada con la spec publicada.

Guías relacionadas

Crear un Solution Design con IA — generar un diseño en Markdown a partir de la documentación de Cobre en vivo

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

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

Generar código con MCP — prompts para andamiar código desde la spec en vivo

Comenzar — Accounts, Counterparties y Money Movements

Autenticación — obtener y reutilizar tokens de API

Pruebas generales — entorno QA y qué puede probar

Proceso de Certificación — cuestionario, demo en vivo y reporte

Gestión de cambios en la API y productos — cómo Cobre le notifica cuando cambian las APIs

Cómo integrarse con Cobre

El recorrido#

1. Pre-sales#

2. Cuándo puede empezar la integración#

3. Integration#

4. Construir en QA#

5. Certification y go-live#

6. Después del go-live#

Guías relacionadas#

El recorrido

1. Pre-sales

2. Cuándo puede empezar la integración

3. Integration

4. Construir en QA

5. Certification y go-live

6. Después del go-live

Guías relacionadas