Payouts en stablecoins

Los Payouts en stablecoins permiten a los clientes enviar stablecoins desde un Cobre Balance hacia la wallet de una contraparte Global verificada. Hay dos tipos de Money Movement según el balance origen.

Enviar un Payout en stablecoins

MM `type`	Source balance	Destination
`stable_payout`	Balance `usd_stable` (`pr_stable_omnibus_cobre`)	Contraparte Global (`global_deposit_le` / `global_deposit_np`)
`global`	Balance fiat Global `usd` (`pr_global_cobre`)	Contraparte Global (`global_deposit_le` / `global_deposit_np`) — fondeado vía on-ramp automático

Ambos tipos se crean a través de la misma API Create a Money Movement — Cobre infiere el tipo a partir del provider de la cuenta source_id. Para la variante global (payout fondeado desde un balance fiat), consulta la guía existente Payouts globales en stable, que cubre en detalle chains, tokens y tipos de contraparte compatibles.

stable_payout solo está disponible para balances usd_stable. Los balances copco no admiten payouts — están en circuito cerrado.

Términos clave

Stable Payout: Un payout enviado directamente desde un balance usd_stable (tipo stable_payout).

Global Payout: Un payout enviado desde un balance fiat Global, fondeado vía on-ramp automático a stablecoins (tipo global).

Global Counterparty: La wallet beneficiaria verificada que recibe el payout — consulta Gestión de contrapartes.

Ciclo de vida del payout

Un Payout en stablecoins sigue un ciclo de vida simple:

1. Crea una contraparte (beneficiario)
Crea una contraparte de tipo global_deposit_le o global_deposit_np con la información de wallet del beneficiario y espera el estado verified.

See 🔗 Create a Counterparty y Gestión de contrapartes.

2. Crea un Money Movement
Crea un Money Movement usando:

El account_id (balance usd_stable o fiat Global) desde el cual se debitarán los fondos, usado como source_id.

El counterparty_id del paso anterior como destination_id.

El monto en la unidad más pequeña de la moneda.

See 🔗 Create a Money Movement.

3. El Money Movement se procesa
Una vez creado, el Money Movement inicia en estado initiated. Si todas las validaciones pasan, el estado cambia a processing y la transacción se transmite on-chain.

4. Espera el resultado final del Money Movement

Si completed, el beneficiario recibió los fondos y tracking_key contiene el hash on-chain.

Si failed o rejected, los fondos se acreditan automáticamente de vuelta al balance origen.

Rastrea las transacciones resultantes vía 🔗 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 Payouts en stablecoins

🔑 Create

🔍 Retrieval

Description: Crea un Money Movement de tipo stable_payout o global.
What to expect after the action: Un Money Movement en estado initiated, progresando por processing hasta completed, failed o rejected.
📘 Learn more:

🔗 Create a Money Movement

Cómo empezar

Registra y verifica la contraparte beneficiaria

Crea una contraparte global_deposit_le o global_deposit_np y espera el estado verified antes de intentar un payout. Consulta Gestión de contrapartes.

Fondea el balance origen

Asegúrate de que el balance origen (usd_stable o fiat Global) tenga fondos suficientes antes de crear el payout.

Implementa Webhooks para rastrear el estado del payout

Suscríbete a eventos de estado de Money Movement para rastrear el payout a lo largo de su ciclo de vida en lugar de hacer polling.

See Notifications & Subscriptions for more details.

Qué esperar tras usar esta API

El Money Movement se inicia

El Money Movement inicia en estado initiated mientras Cobre valida fondos y contraparte.

Los fondos se debitan y se envían on-chain

Una vez en processing, el balance origen se debita y la transacción se ejecuta on-chain.

El Money Movement alcanza un estado final

En completed, el tracking_key de la transacción contiene el hash on-chain. En failed, los fondos se devuelven automáticamente al balance origen.

Payouts en stablecoins

Enviar un Payout en stablecoins#

Términos clave#

Ciclo de vida del payout#

Acciones permitidas sobre Payouts en stablecoins#

Cómo empezar#

Qué esperar tras usar esta API#

Enviar un Payout en stablecoins

Términos clave

Ciclo de vida del payout

Acciones permitidas sobre Payouts en stablecoins

Cómo empezar

Qué esperar tras usar esta API