如何与 Cobre 集成

这是 Cobre API 集成的客户视角：您做什么、等什么、问谁。您的 Key Account Manager（KAM，关键客户经理） 是商务对接人。他们会告知您账户的下一步 — 包括 Solution Design 如何产出，以及实施期间由谁支持您。

全程使用开发工具包：使用 AI 创建解决方案设计、借助 AI 进行开发、使用 MCP 生成代码和探索 API 工作流示例。

旅程

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

阶段	对您意味着什么
Pre-sales	商务与技术沟通。此时您尚未针对 Cobre 的集成环境进行开发。
Integration	确认将要实施的设计，随后由工程师构建并测试。
Certification / Go-live	演示集成，Cobre 在进入生产前予以认证。
Support	KAM 仍是对接人。若适用于您的账户，他们会介绍其他 Cobre 联系人。

1. Pre-sales

与您的商务联系人及 KAM 协作。典型活动：产品契合、提案、尽职调查与合同讨论。

KAM 会分享技术团队所需的文档 — 包括本开发工具包。此时您还不需要生产环境凭证。请阅读快速入门，了解平台模型（Accounts、Counterparties、Money Movements）。

2. 何时可以开始集成

仅当以下全部成立时，集成工作才开始。由您的 KAM 确认 — 您无需跟踪 Cobre 的内部系统。

商务协议已签署或处于签署阶段。

已为您的账户指定 Key Account Manager。

Cobre 已为您开启 API onboarding。

在此之前，您仍处于 pre-sales。若工程师已提前就绪，请告知 KAM — 他们会说明凭证与环境何时可用。

3. Integration

遵循 KAM 设定的顺序。典型路径如下：

与 KAM 对齐

说明： 根据预期业务量与集成复杂度，KAM 可能安排一次技术启动会，邀请您的团队与 Cobre Solution Engineer 参加。

行动后的预期结果： 您知道 Cobre 侧的联系人是谁，以及下一步是什么。

确认将要实施的设计

说明： 您也可以用自己的团队，通过使用 AI 创建解决方案设计起草一份 Solution Design。仅当 KAM 决定引入 Solution Engineer 时，Cobre 才会撰写 Solution Design。

行动后的预期结果： 产品与工程团队有一份可对照实施的设计。

开始开发

说明： 告知 KAM 开发已开始。需要时向其申请 QA 凭证。参见在 QA 中构建。

若 KAM 判断预期业务量与集成复杂度较高，您的团队可能通过 Slack、WhatsApp 群组或电子邮件获得 Cobre Integration Engineer 支持。

行动后的预期结果： 您的团队在 Cobre 测试环境中实施约定流程（以该环境已开放的产品为准）。

4. 在 QA 中构建

向 KAM 申请 QA 凭证（client_id 和 client_secret）。按身份验证进行鉴权。QA 基础域名为 https://api.qa.cobre.co。

并非所有产品都在 QA 中可用。请查看通用测试中的当前矩阵（例如，部分墨西哥与 Cross Border 能力不在 QA）。使用测试用例了解推荐的成功路径与失败路径。

构建期间：

需求	使用
平台模型	快速入门与 API 快速入门
IDE 中的实时 OpenAPI 规范	借助 AI 进行开发
API 序列	探索 API 工作流示例
根据规范搭脚手架	使用 MCP 生成代码
以文档为依据的问答	将 Cobre 文档接入 AI
API 与产品变更通知	管理 API 与产品变更

在生成代码或 Solution Design 之前，请在同一对话中刷新 Cobre Docs MCP。不要凭记忆或过期的规范缓存实施。

5. Certification 与 go-live

当集成已可运行时，通过您的 KAM（或对接的 Integration Engineer）申请认证。完整说明：认证流程。

会前准备：

阅读问卷并能够作答。

准备所实施流程的现场演示。

会议涵盖问卷，以及针对 Cobre QA 或生产环境的现场演示（取决于可用性）。随后 Cobre 出具认证报告（分数、反馈、问题、建议）。仅在集成通过认证，或您完成所需调整之后，才能进入生产。

6. Go-live 之后

KAM 与 Integration Engineer 仍是生产问题、新产品以及 API 变更沟通的对接人。KAM 会告知您，go-live 之后是否仍有其他 Cobre 联系人参与。

请关注管理 API 与产品变更，使实施与已发布规范保持一致。

如何与 Cobre 集成

旅程#

1. Pre-sales#

2. 何时可以开始集成#

3. Integration#

4. 在 QA 中构建#

5. Certification 与 go-live#

6. Go-live 之后#

相关指南#

旅程

1. Pre-sales

2. 何时可以开始集成

3. Integration

4. 在 QA 中构建

5. Certification 与 go-live

6. Go-live 之后

相关指南