稳定币入款

稳定币入款使客户能够将外部发送方的稳定币接收到与 Cobre 余额关联的自托管钱包。根据目标余额不同有两种结果，且每笔存款在入账前自动进行合规筛查。

接收稳定币入款

目标余额	交易 `currency`	结果
`usd_stable` 余额（`pr_stable_omnibus_cobre`）	`usd_stable`	资金直接以稳定币入账
Global 法币余额（`pr_global_cobre`）	`usd`	资金自动 off-ramp 并以 USD 法币入账

两种变体均使用同一 Create an Account Reference API（类型 self_custodian_wallet）— Cobre 根据接收账户的 provider 推断目标币种。参见管理稳定币余额与钱包了解如何在任一余额类型上配置钱包。钱包启用后，客户无需操作即可接收入款；Cobre 通过 webhook 自动检测链上存款。

入款时的自动 off-ramp 仅适用于 pr_global_cobre（USD Global 法币余额）。copco 余额无法接收外部入款 — 其为闭环。

入款支持的网络与代币

Network	Token
Ethereum	USDC, USDT
Polygon	USDC, USDT
Tron	USDT
Stellar	USDC

不支持的链/代币组合存款不会被检测或入账。

合规筛查结果

Outcome	Result
Approved	资金入账至余额
Blocked wallet	资金不入账；钱包被永久 blocked（终态）
Error / timeout	该笔特定存款不入账，但钱包仍可运营

关键术语

Payin：从外部钱包接收到 Cobre 关联钱包的稳定币存款。

自动 Off-Ramp：当入款进入 pr_global_cobre 余额时，Cobre 在入账过程中自动将稳定币转换为 usd 法币。

Compliance screening：存款入账前对发送方钱包执行的自动审查。

Sweep：筛查通过后，将已批准存款从客户钱包转移至 Cobre 金库的内部流程。

入款生命周期

稳定币入款遵循简单生命周期：

1. 创建目标余额
创建 metadata.currency: usd_stable 的 Cobre 余额以直接接收稳定币入款，或使用 Global 法币余额（pr_global_cobre）以接收自动 off-ramp 至 usd 的入款。

参见 🔗 Create or Connect an Account。

2. 创建与该余额关联的自托管钱包
使用上一步的 account_id 以及要接收的 chain 与 token，创建 self_custodian_wallet 类型的 Account Reference。

参见 🔗 Create an Account Reference。

3. 等待钱包 enabled
钱包初始为 connectivity.status: processing。轮询或等待其达到 enabled — 🔗 List one Account Reference — 再将 value（链上地址）分享给发送方。

4. 检测并筛查存款
Cobre 通过 webhook 检测链上存款，并在入账前筛查发送方钱包。

5. 资金入账
批准后，在目标余额上生成 global_credit 交易 — 目标为 stable 余额时 currency 为 usd_stable，目标为 pr_global_cobre 时自动 off-ramp 并以 usd 入账。无论哪种情况，资金均 sweep 至 Cobre 金库。

参见 🔗 Obtain one Transaction 或 🔗 Obtain all Transactions 进行追踪。