StableFX

StableFX permite a los clientes convertir entre sus balances usd_stable y copco usando la misma infraestructura de FX Quote y Cross-Border Money Movement empleada para corredores fiat.

Para la visión conceptual, consulta StableFX.

Convertir entre usd_stable y COPco

1. Solicita una FX Quote

Solicita una cotización vía la API Create a FX Quote usando currency_pair: usd_stable/copco o currency_pair: copco/usd_stable.

Solo type: static_quote está actualmente soportado para este par.

2. Ejecuta la conversión

Referencia el id de cotización en la API Create a Cross Border Money Movement, junto con los balances origen y destino usd_stable/copco.

StableFX solo opera entre balances usd_stable y copco. Tanto source_id como destination_id deben ser uno de estos dos tipos de balance.

Términos clave

FX Quote: Una oferta con precio y tiempo limitado para una conversión de par de monedas.

Static Quote: Una cotización a tasa fija válida hasta que expire.

Cross-Border Money Movement: El objeto que representa la conversión ejecutada, referenciando la cotización usada.

Ciclo de vida de la conversión

Una conversión StableFX sigue un ciclo de vida simple:

1. Solicita una FX Quote
Solicita una static_quote para el par usd_stable/copco o copco/usd_stable.

See 🔗 Create a FX Quote.

2. Ejecuta la conversión antes de que expire la cotización
Crea un Cross Border Money Movement referenciando el id de cotización, con source_id y destination_id como balances usd_stable/copco.

See 🔗 Create a Cross Border Money Movement.

3. El Money Movement se procesa
Una vez creado, el Money Movement inicia en estado initiated. Convertir hacia copco emite (mint) COPco on-chain; convertir fuera de él lo destruye (burn). 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 cbmm_debit en el balance origen y una cbmm_credit 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 StableFX

🔑 Create Quote

🔑 Execute Conversion

🔍 Retrieval

Description: Solicita una cotización estática para el par usd_stable/copco o copco/usd_stable.
What to expect after the action: Un objeto quote con el fx_rate aplicable y una expiración valid_until.
📘 Learn more:

🔗 Create a FX Quote

Cómo empezar

Crea ambos balances stablecoin

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

Fondea el balance origen

Asegúrate de que el balance origen tenga fondos suficientes antes de ejecutar la conversión.

Ejecuta con prontitud tras cotizar

Las cotizaciones son válidas por una ventana limitada — ejecuta la conversión antes de que expire o solicita una nueva cotización.

Qué esperar tras usar esta API

La conversión se inicia

El Cross Border Money Movement inicia en estado initiated.

Se confirma el mint o burn on-chain

Convertir hacia copco emite COPco; convertir fuera de copco lo destruye. El crédito destino solo se registra una vez confirmada esta operación.

Se generan transacciones

Una transacción cbmm_debit en el balance origen y una cbmm_credit en el balance destino se crean una vez completada la conversión.

StableFX

Convertir entre usd_stable y COPco#

1. Solicita una FX Quote#

2. Ejecuta la conversión#

Términos clave#

Ciclo de vida de la conversión#

Acciones permitidas sobre StableFX#

Cómo empezar#

Qué esperar tras usar esta API#

Convertir entre usd_stable y COPco

1. Solicita una FX Quote

2. Ejecuta la conversión

Términos clave

Ciclo de vida de la conversión

Acciones permitidas sobre StableFX

Cómo empezar

Qué esperar tras usar esta API