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

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

平台还提供 delete 接口端点，支持针对部分服务商在 Cobre 平台上注销账户。

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

平台支持通过 Create a Cobre Balance API 在其运营地区创建 "Virtual Balances"。这些账户是访问平台各类服务的基础，具体功能因地区而异。Virtual Balances 在 Cobre 环境中是一种多用途资产，可有效提升资金灵活性。

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

要有效使用 Create a Cobre Balance API，需提供服务商 ID 并指定操作类型，以确保 API 能够准确处理您的请求。

账户 API 中，虚拟余额服务商仅支持 create 操作。

Colombia Balances

Mexico Balances

USA Balances

Global Balances

以下列表包含哥伦比亚所有可用的虚拟余额服务商及其支持的服务。这些账户是访问平台各类服务（包括快速支付）的基础。

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

虚拟余额支持的操作

🔑 Create

🔍 Retrieval

✍️ Update

🪢 Account Linkage

⛓️‍💥 Account Unlinkage

❌ Close

描述： 创建虚拟余额账户。
操作完成后： Virtual Balance 状态变为 Created。
📘 了解更多： 🔗 Create a 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

根据所需地区或币种选择正确的服务商。详情请参阅上方 虚拟余额服务商目录 章节。

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 Balance，再统一汇聚至单一 Virtual Balance 或本地账户。

更多详情请参阅账户关联。

Subscribe to transaction notifications

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

交易入账（例如 accounts.balance.credit）

交易出账（例如 accounts.balance.debit）

更多详情请参阅通知与订阅

使用此 API 后的预期效果

Start moving money

发款

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

至其他 Virtual Balances——将另一个 Virtual Balance 作为收款目标

从全球美元 Virtual Balances 向 ETH、Tron、Solana、Polygon、Base 和 XRPL 上的稳定币钱包转账

批量操作至本地账户——请参阅批量资金流动指南

通过定时归集，从多个 Virtual Balances 归集至某一 Virtual Balance 或本地账户——请参阅资金流动调度指南

收款

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

在墨西哥通过虚拟 CLABE 与 SPEI 收款——请参阅虚拟 CLABE 指南

从 ETH/Polygon 和 Tron 上的稳定币热钱包收款至美元全球余额

Get Virtual Balances transaction information on demand

使用本指南相应章节中指定的 Cobre Balance 交易 接口端点，获取影响 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）服务商目录#

虚拟余额支持的操作#

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

如何开始使用#

使用本 API 前的准备#

使用此 API 后的预期效果#

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

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

虚拟余额支持的操作

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

如何开始使用

使用本 API 前的准备

使用此 API 后的预期效果