管理稳定币余额与钱包

本指南涵盖创建并持有 usd_stable 与 COPco 余额，以及配置自托管钱包以链上接收稳定币（仅 usd_stable — COPco 为 closed loop，不使用钱包）。

创建稳定币余额

稳定币余额通过 Create a Cobre Balance API 创建，使用 provider pr_stable_omnibus_cobre。同一 provider 支持两种货币，通过 metadata.currency 选择：

`metadata.currency`	Balance	On-chain wallets	Payins / Payouts	Rewards
`usd_stable`	USD stablecoin	Yes	Yes	No
`copco`	COPco (closed loop)	No	No	Yes

账户异步创建：初始响应返回 connectivity.status: connecting，客户端应轮询账户直至达到 connected。

仅 usd_stable 余额支持自托管钱包与链上入款/出款。copco 余额仅支持与 COP 法币的 on/off-ramp 及每日奖励 — 参见稳定币注资与 COPco 奖励。

要链上接收稳定币，在 usd_stable 余额上通过 Create an Account Reference API 创建 self_custodian_wallet 类型的 Account Reference，在 metadata.chain 中指定网络：

钱包创建为异步：connectivity.status: processing 且 value 为空，地址由钱包基础设施 provider 配置后转为 enabled。

copco 余额不支持自托管钱包 — 当前阶段为 closed loop。

Stable Balance：使用 provider_id: pr_stable_omnibus_cobre 创建的 Cobre 余额，持有 usd_stable 或 copco。

Self-Custodian Wallet：self_custodian_wallet 类型的 Account Reference，代表代表余额接收稳定币的链上地址。

Chain：钱包运行的区块链网络（evm_compatible、tron、stellar）。

🔑 Create Balance

🔍 Retrieve Balance

🔑 Create Wallet

🔍 Retrieve Wallet

Description: 创建稳定币余额（usd_stable 或 copco）。
What to expect after the action: connecting 状态的余额对象，配置完成后转为 connected。
📘 Learn more:

确定所需货币

若需链上入款/出款与钱包，选择 usd_stable；若仅需持有 COP 计价价值并获得奖励，选择 copco。

为钱包选择网络（仅 usd_stable）

根据交易对手或发送方所在网络，选择 evm_compatible、tron 或 stellar。

实现 Webhooks 追踪配置进度

余额与钱包均为异步配置。订阅相关事件以追踪最终状态，而非轮询。

余额达到 connected 状态

配置完成后，余额可接收 on/off-ramp 转移；对 usd_stable，还可进行入款与出款。

钱包达到 enabled 状态并含地址

钱包配置完成后，value 包含真实链上地址。将此地址分享给发送方以开始接收稳定币入款 — 参见稳定币入款。