管理虚拟余额账户（Cobre Balances）

虚拟余额账户（Cobre Balances）API 提供用于设置、维护和管理虚拟余额账户的服务。为此，平台将开放一组不同的 API 和接口端点，客户可通过这些服务注册账户，并获取所有已注册账户及其相应信息。

平台还提供 delete 接口端点，供客户针对部分服务提供商在 Cobre 平台上关闭账户。

创建虚拟余额账户（Cobre Balances）

平台支持通过 创建 Cobre Balance API 在其运营地区创建 "Virtual Balances"。这些账户是访问一系列平台服务的基础，具体取决于所在地区。Virtual Balances 在 Cobre 环境中作为多功能资产，提升了资金灵活性。

虚拟余额账户（Cobre Balance）服务提供商目录

有效使用 创建 Cobre Balance API 时，需提供服务提供商 ID 及操作类型说明，以确保 API 能准确处理您的请求。

账户 API 中仅支持对 Virtual Balance 服务提供商执行 create 操作。

Colombia Balances

Mexico Balances

Global Balances

以下列表包含哥伦比亚所有可用的 Virtual Balance 服务提供商及其可用服务。这些账户是访问一系列平台服务（包括快速支付）的基础。

Code	Supplier	Create	Balances	Transactions	Payments
pr_col_cobre	Cobre Balance Colombia	Yes	Yes	Yes	Yes

对 Virtual Balance 执行的操作

🔑 Create

🔍 Retrieval

✍️ Update

🪢 Account Linkage

⛓️‍💥 Account Unlinkage

❌ Close

描述： 创建 Virtual Balance 账户。
操作完成后预期结果： Virtual Balance 处于 已创建 状态。
📘 了解更多： 🔗 创建 Cobre Balance

虚拟余额账户（Cobre Balance）交易记录

🔍 Retrival

🗂️ Daily Balance History

描述： 🔎 获取与所有 Virtual Balances 或特定 Virtual Balance 相关的所有交易记录，以及与特定 Virtual Balance 相关的交易记录。
操作完成后预期结果： 交易信息列表（如借记和贷记）或特定交易的详细信息。
📘 了解更多：

获取所有客户交易记录

获取账户交易记录

获取单笔交易记录

如何开始使用

在开始使用前，建议您对使用本方案所需的前期准备步骤有清晰的了解。

使用本 API 前

When creating a Virtual Balance, use the right provider_id according to the region and currency required

根据所需地区或币种选择正确的服务提供商。详情请参阅上方 Virtual Balance 服务提供商目录 部分。

Think on the number of Virtual Balances you need

决定使用一个还是多个 Virtual Balances 来管理支付信息。例如，在电商平台中，可为每个商户分别设置一个 Virtual Balance，以便在各自对应的 Virtual Balance 中独立追踪每个商户的相关交易。

Decide if linking a Primary account makes sense for your use case

已设置主账户的 Virtual Balances 将自动将任何贷记交易归集至该主账户。这对于收款场景非常有用——在独立的 Virtual Balances 中接收资金是合理的，但后续需要将所有资金汇总至单个 Virtual Balance 或本地账户。

详情请参阅账户关联。

Subscribe to transaction notifications

订阅交易通知，以接收以下信息：

交易贷记通知（例如 accounts.balance.credit）

交易借记通知（例如 accounts.balance.debit）

详情请参阅通知与订阅

使用本 API 后的预期结果

Start moving money

发送资金

至本地账户 - 请参阅哥伦比亚和墨西哥的 Local Payouts 指南

至其他 Virtual Balances - 将另一个 Virtual Balance 作为目标账户

从全球 USD Virtual Balances 向 ETH、Tron、Solana、Polygon、Base 和 XRPL 上的稳定币钱包发送资金

批量操作至本地账户 - 请参阅批量资金转移指南

通过定时归集，从多个 Virtual Balances 汇至某一 Virtual Balance 或本地账户 - 请参阅资金转移调度器指南

收取资金

在哥伦比亚通过 Bre-B、PSE、Nequi、Nequi Direct Debit 及 Bancolombia Button 收款 - 请参阅 Checkout 指南和 Direct Link 指南

在墨西哥通过 Virtual CLABEs 使用 SPEI 收款 - 请参阅 Virtual CLABEs 指南

从 ETH/Polygon 和 Tron 上的稳定币热钱包收款至 USD Global Balances

Get Virtual Balances transaction information on demand

使用本指南对应章节中指定的 Cobre Balance transactions 接口端点，获取影响该 Virtual Balance 的借记和贷记记录。

Track debits and credits on a Virtual Balance Account

当存在对 accounts.balance.credit 和 accounts.balance.debit 事件类型的有效订阅时，接收 Virtual Balance 上每笔贷记和借记交易的 Webhook 通知。

请参阅通知与订阅

Assign Bre-B keys to Colombian Virtual Balances

分配静态 Bre-B Keys，可将其共享以在 Virtual Balance 中收取资金。

请参阅 Cobre Keys 指南

Convert between currencies

实时进行货币兑换，以支持跨境转账使用场景

请参阅 CrossBorder Payments

管理虚拟余额账户（Cobre Balances）

创建虚拟余额账户（Cobre Balances）#

虚拟余额账户（Cobre Balance）服务提供商目录#

对 Virtual Balance 执行的操作#

虚拟余额账户（Cobre Balance）交易记录#

如何开始使用#

使用本 API 前#

使用本 API 后的预期结果#

创建虚拟余额账户（Cobre Balances）

虚拟余额账户（Cobre Balance）服务提供商目录

对 Virtual Balance 执行的操作

虚拟余额账户（Cobre Balance）交易记录

如何开始使用

使用本 API 前

使用本 API 后的预期结果