快速入门

以下指南作为入门参考，概述了 Cobre 生态系统内各要素之间的关系，以及用户或外部系统如何操作 Cobre 的基础功能，从而为使用我们产品奠定基础。

本指南将帮助您理解 Cobre 基础要素行为背后的关联逻辑，以便在深入了解具体产品之前，先建立整体认知。

与 Cobre 交互的两种方式

Cobre 提供两种灵活的集成路径，以满足您的具体运营需求：

1. API 集成 —— 系统间自动化

Cobre API 支持对我们支付基础设施的直接编程访问，允许任何外部系统与我们的服务无缝交互：

贵公司的内部应用 —— 将支付功能直接嵌入您的产品

后端服务 —— 构建自定义支付工作流与自动化流程

ERP 或财务系统 —— 端到端集成财务运营

移动应用 —— 实现随时随地的支付能力

优势： 完全自定义、全面自动化、白标能力，以及灵活构建完全符合业务需求的定制化支付体验。

2. Cobre Portal —— 人工驱动的运营

Cobre Portal 为需要直接、实操交互的团队提供直观的 Web 界面：

资金管理团队 —— 手动发起和接收付款

财务运营 —— 管理配置与设置

运营人员 —— 无需技术知识即可执行交易

优势： 无需开发、更快上线、用户友好的界面及内置工作流。Portal 在底层同样调用 Cobre API，并针对常见使用场景进行了预配置。

哪种方式适合您？

选择 API 集成，如果您需要：

根据业务逻辑定制的支付流程

自动化、高并发的交易处理

将支付嵌入您的产品或应用

对用户体验和工作流的完全掌控

选择 Portal，如果您需要：

无需开发资源的快速实施

人工审核与审批流程

针对标准支付操作的开箱即用方案

非技术团队成员的便捷访问

或者两者并用：

许多客户在运营团队使用 Portal 的同时，也通过 API 实现自动化流程——两全其美。

Cobre 平台

大容器 Cobre Platform 涵盖了 Cobre 所开放的所有主要金融能力。

Accounts

Counterparties

Local Money Movements

Cross Border Money Movements

Transactions

Reports & Reconciliation （间接体现）

以下将逐一说明各项内容。

3. Accounts —— 资金与关联银行账户管理

Accounts 包含两大核心概念：

3.1 Cobre Balances：虚拟余额账户与虚拟账户

Cobre Balances 是以不同货币（COP、MXN、USD）计量的数字账本，可作为资金流动的 来源或目的地。

Cobre Balances 帮助企业更高效、灵活地管理现金流，不受传统银行系统的局限。

通过开通 Cobre Balance，我们的客户可以访问我们所有的金融解决方案，无论是境内支付还是国际支付。

Cobre Balance 设计为全天候（7×24）运行的 "虚拟余额账户"，支持您：

发起出款及跨境转账

接收收款（例如：Checkout、直接链接、虚拟 CLABE、Keys）

保存完整的交易历史记录

该余额作为一种流动性强、用途广泛的资产，实现实时财务管控，消除对账流程中的摩擦，并优化资金可用性。通过按地区集中管理运营资金，企业可获得更强的可见性、敏捷性和掌控力，以更快的速度运营业务。

Cobre Balances 分为两种类型：

虚拟余额账户（Virtual Balance Account）：

此类 Cobre Balance 不与金融网络中的特定账户绑定。

只能通过 Cobre 可用的支付通道在这些 Cobre Balances 中收发资金，无法直接通过金融网络操作。

虚拟账户（Virtual Account）：

与虚拟余额账户不同，此类 Cobre Balance 与金融系统中的特定账户绑定（例如：墨西哥的 CLABE 账户）。

可通过 Cobre 可用的支付通道，以及直接通过金融网络中的账号（例如：通过墨西哥 SPEI 从银行直接转账）在这些 Cobre Balances 中收发资金。

客户可根据需要创建任意数量的 Cobre Balances，且仅 COP 和 MXN 的 Cobre Balances 支持 Local Payments。

3.2 Connect Accounts

这些是客户关联至 Cobre 的 外部金融机构账户。
用途包括：

查看银行交易记录

发起 ACH 出款

客户可连接任意数量的银行账户。请参阅 Connect bank accounts with Cobre，了解该产品及各地区可用银行的详细信息。

4. Counterparties

交易对手方（Counterparty） 是指在资金流动中作为收款方或付款方参与的任何个人或银行账户。它代表在 Cobre 支付流程中，交易另一端的主体。

理解交易对手方角色

交易对手方的角色及所需信息因资金流动类型而异：

对于 PayOuts（出款）

交易对手方代表 受益人 —— 即接收资金的收款方：

银行账户信息 —— 账号、银行代码、账户类型

受益人信息 —— 全名、身份证件、联系方式

用途 —— 资金去向及接收方身份

客户可根据需要创建任意数量的交易对手方。

对于 PayIns（收款）

交易对手方代表 付款人 —— 即向您汇入资金的个人或实体：

付款人身份信息 —— 向您付款的主体

付款来源信息 —— 来源账户或付款方式信息

参考数据 —— 将入账付款关联至您的内部记录（发票、订单等）

5. Local Money Movements — 境内转账（墨西哥与哥伦比亚）

在 Cobre，Money Movements 是构建所有支付体验的基础。Money Movement 是指在 Cobre 平台内涉及两方之间资金流转的任何操作。Local Money Movements 代表一个国家内的所有境内转账，包括本地资金入账（PayIn）和向第三方付款（PayOut）。

示例：

SPEI 出款（墨西哥）

ACH 与 Fast Pay 出款（哥伦比亚）

Bre-B 出款（哥伦比亚）

收款（Payins） 方式包括：

Checkout

Direct Link

R2P（Bancolombia、Nequi、PSE、Bre-B）

虚拟 CLABE

哥伦比亚动态收款码

本地资金流动特点：

以 Cobre Balance 或 Counterparty 作为资金来源或目的地

出款或收款均需指定 Counterparty

生成 Transactions，影响 Cobre Balances 和银行账户

仅以本地货币运作

这是运营境内支付流程的核心所在。

无论是向客户收款、向供应商付款，还是进行跨境资金转移，每一笔资金流动均具备完整的可追溯性、即时对账能力和实时可见性。

6. Cross Border Money Movements — 国际转账

Cross Border Money Movements 支持您以实时汇率和透明定价，跨多种货币发送和接收国际付款。

功能概述

通过 Cross Border 支付，您的企业可以：

全球资金调拨 — 以美元、哥伦比亚比索、墨西哥比索及其他货币收发资金

锁定汇率 — 在执行转账前，通过报价系统获取有保障的汇率

全天候运营 — 不受银行营业时间或 FX 交易窗口限制，随时处理国际付款

实时追踪 — 从报价到结算，全程监控每笔交易，保持完整可见性

7. Transactions（交易）

每一笔 Money Movement——无论是境内还是跨境——都会生成一条或多条 Transactions。
Transactions 代表实际发生的借记和贷记操作，作用于：

Cobre Balances

已连接的银行账户（仅限 Local Payments）

它可以是借记（资金流出）或贷记（资金流入）。
每条交易记录均包含关键信息，例如金额、操作类型、资金来源或目的地，以及发生日期。

它们是账户对账和报告的核心依据。

Transactions 反映：

入账资金

出款支付

货币兑换

这正是前述章节图示中 Transactions → 影响 → 账户与银行账户 的原因。

8. 各组件如何协同运作

前述关系说明了 Cobre 如何构建完整的支付生命周期：

The Client App or an individual using the Portal initiates operations

创建账户

创建 Counterparties

触发 Money Movements

发起 Cross Border 转账

Local Money Movements interact with Accounts and Counterparties

境内出款需关联 Counterparties

可追踪 Money Movement 状态直至完成

Cobre Balances 相应借记或贷记

Cross Border transfers interact with Cobre Balances

本地余额与全球余额之间的资金流动

FX 报价定义目标金额或基准金额

可追踪 Cross Border Money Movement 状态直至完成

Cobre Balances 相应借记或贷记

Every flow generates information that can be later consulted

这些数据支持报告、对账和运营可见性

可将外部信息关联至每笔资金流动，便于对账

该架构确保了可审计性、一致性和统一的财务模型，无论客户在哪些支付轨道或国家/地区开展业务。

9. 总结

本指南详细介绍了 Cobre 金融生态系统如何作为统一账本和资金流动引擎运作：

客户应用程序或通过 Portal 操作的个人负责下达指令

账户持有资金并连接实际银行账户

Counterparties 支持向外部收款方付款

本地及跨境资金流动执行具体的财务操作

Transactions 记录余额的每一项变动

该架构提供了一套可扩展、可审计、覆盖多国的资金流动体系，适用于金融科技公司、平台电商、借贷机构和企业级平台。

快速入门

与 Cobre 交互的两种方式#

1. API 集成 —— 系统间自动化#

2. Cobre Portal —— 人工驱动的运营#

哪种方式适合您？#

选择 API 集成，如果您需要：#

选择 Portal，如果您需要：#

或者两者并用：#

Cobre 平台#

3. Accounts —— 资金与关联银行账户管理#

3.1 Cobre Balances：虚拟余额账户与虚拟账户#

3.2 Connect Accounts#

4. Counterparties#

理解交易对手方角色#

对于 PayOuts（出款）#

对于 PayIns（收款）#

5. Local Money Movements — 境内转账（墨西哥与哥伦比亚）#

示例：#

本地资金流动特点：#

6. Cross Border Money Movements — 国际转账#

功能概述#

7. Transactions（交易）#

8. 各组件如何协同运作#

9. 总结#

与 Cobre 交互的两种方式

1. API 集成 —— 系统间自动化

2. Cobre Portal —— 人工驱动的运营

哪种方式适合您？

选择 API 集成，如果您需要：

选择 Portal，如果您需要：

或者两者并用：

Cobre 平台

3. Accounts —— 资金与关联银行账户管理

3.1 Cobre Balances：虚拟余额账户与虚拟账户

3.2 Connect Accounts

4. Counterparties

理解交易对手方角色

对于 PayOuts（出款）

对于 PayIns（收款）

5. Local Money Movements — 境内转账（墨西哥与哥伦比亚）

示例：

本地资金流动特点：

6. Cross Border Money Movements — 国际转账

功能概述

7. Transactions（交易）

8. 各组件如何协同运作

9. 总结