Gestión de balances y wallets de stablecoins

Esta guía cubre la creación y tenencia de balances usd_stable y COPco, y la provisión de wallets de autocustodia para recibir stablecoins on-chain (solo usd_stable — COPco es circuito cerrado y no usa wallets).

Crear un balance stablecoin

Un balance stablecoin se crea a través de la API Create a Cobre Balance usando el provider pr_stable_omnibus_cobre. El mismo provider admite dos monedas, seleccionadas vía 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

La cuenta se crea de forma asíncrona: la respuesta inicial retorna connectivity.status: connecting, y los clientes deben consultar (poll) la cuenta hasta que alcance connected.

Solo los balances usd_stable admiten wallets de autocustodia y payins/payouts on-chain. Los balances copco solo admiten on/off-ramp con fiat COP y recompensas diarias — consulta Fondeo de stablecoins y COPco y Recompensas.

Provisionar una wallet de autocustodia

Para recibir stablecoins on-chain, crea un Account Reference de tipo self_custodian_wallet sobre un balance usd_stable vía la API Create an Account Reference, especificando la red en metadata.chain:

`metadata.chain`	Networks covered	Supported tokens
`evm_compatible`	Ethereum, Polygon (single wallet address)	USDC, USDT
`tron`	Tron	USDT
`stellar`	Stellar	USDC

La creación de wallet es asíncrona: la wallet inicia en connectivity.status: processing con un value vacío, y transiciona a enabled una vez que el proveedor de infraestructura de wallets provisiona la dirección.

Las wallets de autocustodia no son compatibles en balances copco — están en circuito cerrado en la fase actual.

Términos clave

Stable Balance: Un Cobre Balance creado con provider_id: pr_stable_omnibus_cobre, que mantiene usd_stable o copco.

Self-Custodian Wallet: Un Account Reference de tipo self_custodian_wallet, que representa una dirección on-chain que recibe stablecoins en nombre de un balance.

Chain: La red blockchain sobre la que opera una wallet (evm_compatible, tron, stellar).

Acciones permitidas sobre balances y wallets stablecoin

🔑 Create Balance

🔍 Retrieve Balance

🔑 Create Wallet

🔍 Retrieve Wallet

Description: Crea un balance stablecoin (usd_stable o copco).
What to expect after the action: Un objeto balance en estado connecting, que transiciona a connected una vez provisionado.
📘 Learn more:

🔗 Create or Connect an Account

Cómo empezar

Decide qué moneda necesitas

Elige usd_stable si necesitas payins/payouts on-chain y wallets, o copco si solo necesitas mantener valor denominado en COP y ganar recompensas.

Elige una red para tu wallet (solo usd_stable)

Selecciona evm_compatible, tron o stellar según dónde operen tus contrapartes o remitentes.

Implementa Webhooks para rastrear el aprovisionamiento

Tanto balances como wallets se provisionan de forma asíncrona. Suscríbete a los eventos relevantes para rastrear cuándo alcanzan su estado final en lugar de hacer polling.

See Notifications & Subscriptions for more details.

Qué esperar tras usar esta API

El balance alcanza estado connected

Una vez completado el aprovisionamiento, el balance está listo para recibir transferencias on/off-ramp y, para usd_stable, payins y payouts.

La wallet alcanza estado enabled con una dirección

Una vez provisionada la wallet, value contiene la dirección on-chain real. Comparte esta dirección con remitentes para empezar a recibir payins en stablecoins — consulta Payins en stablecoins.

Gestión de balances y wallets de stablecoins

Crear un balance stablecoin#

Provisionar una wallet de autocustodia#

Términos clave#

Acciones permitidas sobre balances y wallets stablecoin#

Cómo empezar#

Qué esperar tras usar esta API#

Crear un balance stablecoin

Provisionar una wallet de autocustodia

Términos clave

Acciones permitidas sobre balances y wallets stablecoin

Cómo empezar

Qué esperar tras usar esta API