Fondeo de stablecoins (On/Off-Ramp)

El Fondeo de stablecoins permite a los clientes convertir entre sus balances fiat y stablecoin, ya sea automáticamente como parte de un payout/payin, o manualmente entre sus propios balances.

Para la visión conceptual, consulta Fondeo de stablecoins.

Convertir entre balances fiat y stablecoin

Las conversiones manuales se crean a través de la API Create a Money Movement, usando source_id y destination_id para referenciar los balances propios del cliente — no interviene contraparte. Cobre infiere la dirección (on_ramp o off_ramp) a partir de los tipos de cuenta.

Corridor	On-Ramp (source → destination)	Off-Ramp (source → destination)
USD	Global fiat → `usd_stable`	`usd_stable` → Global fiat
COP	`pr_col_cobre` (COP fiat) → `copco`	`copco` → `pr_col_cobre` (COP fiat)

El on/off-ramp automático (embebido en un payout/payin sobre el balance fiat Global) solo está disponible para el corredor USD.

Consulta Payouts en stablecoins y Payins en stablecoins. El corredor COP solo admite conversión manual.

Tipos de liquidación para off-ramp de COPco

Al convertir copco de vuelta a fiat COP, especifica metadata.settlement_type:

`settlement_type`	Credit timing	Cost
`standard` (default)	Según ventanas de liquidación	Sin costo
`instant`	Tiempo real	Tiene un costo asociado

El corredor COP implica un mint on-chain (on-ramp) o burn (off-ramp) de COPco. El crédito destino solo ocurre tras confirmarse esa operación on-chain — si falla, el débito origen se revierte automáticamente.

Términos clave

On-Ramp: Conversión de un balance fiat a un balance stablecoin.

Off-Ramp: Conversión de un balance stablecoin de vuelta a un balance fiat.

Settlement Type: Para off-ramp de COPco, si el crédito COP es standard o instant.

Ciclo de vida del fondeo

Convertir entre un balance fiat y uno stablecoin sigue un ciclo de vida simple:

1. Asegúrate de que existan ambos balances
Tanto el balance fiat como el stablecoin deben existir previamente.

See 🔗 Create or Connect an Account y Gestión de balances y wallets de stablecoins.

2. Crea un Money Movement
Crea un Money Movement usando los balances propios del cliente como source_id y destination_id — no interviene contraparte. Cobre infiere on_ramp u off_ramp a partir de los tipos de cuenta.

See 🔗 Create a Money Movement.

3. El Money Movement se procesa
Una vez creado, el Money Movement inicia en estado initiated. Para conversiones copco, se ejecuta un mint (on-ramp) o burn (off-ramp) on-chain una vez que el estado pasa a processing. El crédito destino solo se registra una vez confirmada esa operación; una operación fallida revierte automáticamente el débito origen.

4. Espera el resultado final y revisa las transacciones resultantes
Una vez completed, se generan una transacción de débito en el balance origen y una de crédito en el balance destino.

See 🔗 Obtain one Transaction o 🔗 Obtain all Transactions.

5. Recibe actualizaciones de estado
Los cambios de estado del Money Movement se comunican vía Webhooks.

Acciones permitidas sobre Fondeo de stablecoins

🔑 Create

🔍 Retrieval

Description: Crea un Money Movement entre los balances fiat y stablecoin propios del cliente.
What to expect after the action: Un Money Movement de tipo on_ramp u off_ramp, generando una transacción de débito en el origen y una de crédito en el destino.
📘 Learn more:

🔗 Create a Money Movement

Cómo empezar

Crea ambos balances involucrados

Tanto el balance fiat como el stablecoin deben existir previamente antes de solicitar una conversión. Consulta Gestión de balances y wallets de stablecoins.

Fondea el balance origen

El balance origen debe tener fondos suficientes para el monto solicitado.

Implementa Webhooks para rastrear el estado de la conversión

Suscríbete a eventos de estado de Money Movement, especialmente para el corredor COP donde la finalización depende de una confirmación on-chain.

See Notifications & Subscriptions for more details.

Qué esperar tras usar esta API

El Money Movement se inicia

La conversión inicia en estado initiated.

Se generan dos transacciones

Una transacción de débito en el balance origen y una de crédito en el balance destino se crean una vez completado el Money Movement.

El corredor COP espera confirmación on-chain

Para conversiones copco, el crédito destino solo se registra tras confirmarse el mint o burn. Una operación on-chain fallida revierte automáticamente el débito origen.

Fondeo de stablecoins (On/Off-Ramp)

Convertir entre balances fiat y stablecoin#

Tipos de liquidación para off-ramp de COPco#

Términos clave#

Ciclo de vida del fondeo#

Acciones permitidas sobre Fondeo de stablecoins#

Cómo empezar#

Qué esperar tras usar esta API#

Convertir entre balances fiat y stablecoin

Tipos de liquidación para off-ramp de COPco

Términos clave

Ciclo de vida del fondeo

Acciones permitidas sobre Fondeo de stablecoins

Cómo empezar

Qué esperar tras usar esta API