Payouts globales en stable

El Payout usando Global payouts in stable ofrece servicios para enviar fondos desde un Cobre Balance Global (USD) hacia beneficiarios externos usando la vía de pago stablecoin.

Los Global payouts in stable se usan comúnmente para desembolsar fondos globalmente a direcciones blockchain, ofreciendo liquidación instantánea, disponibilidad 24/7 y movimiento de dinero programable que elimina intermediarios bancarios tradicionales mientras habilita integración fluida con protocolos DeFi y flujos nativos de cripto.

Limitaciones de Global payouts in stable

Global payouts in stable admite las siguientes chains y tokens:

Network (Chain)	Allowed stablecoins
Ethereum	USDT, USDC
Tron	USDT
Solana	USDC
Polygon	USDC
Base	USDC
XRPL	RLUSD

La contraparte debe estar verified para permitir el payout.

Contrapartes compatibles

Global payouts in stable admite los siguientes tipos de destino:

Destination Type	Counterparty Type
Global Deposit Legal Entity	`global_deposit_le`
Global Deposit Natural Person	`global_deposit_np`

Flujo de autorización (opcional)

Checker Approval es una solución opcional que puede usarse dentro del flujo de Payout. Activa un flujo de autorización antes de que la transacción se envíe a la red de pago. Mientras la aprobación está pendiente, el Money Movement permanece en estado pending_approval hasta que se apruebe o rechace. El proceso de aprobación puede completarse a través del Portal de Cobre o programáticamente vía API.

Ciclo de vida del payout

Un Global payouts in stable sigue un ciclo de vida simple:

1. Crea una contraparte Global Deposit Legal Entity o Global Deposit Natural Person (beneficiario)
Crea una contraparte de tipo global_deposit_le o global_deposit_np.
Esta contraparte representa el destino de la transacción de Payout.

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

El account_id desde el cual se debitarán los fondos, usado como source_id (un Cobre Balance Global = pr_global_cobre con metadata.currency="usd").

El counterparty_id del paso anterior como destination_id

Los metadatos con una description y el token

El external_id donde puedes enviar una referencia de tu sistema.

El monto en la unidad más pequeña de la moneda (p. ej., 1.00 USD debe representarse como 100).

Global payouts in stable

amount debe ser al menos 100 (equivalente a 1.00 USD). Los montos se especifican en unidades menores (centavos).
token debe ser una stablecoin compatible. Consulta la matriz de compatibilidad de stablecoins para los valores aceptados.

checker_approval como true si quieres usar nuestro flujo de autorización.

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. En este punto, la transacción se transmite.

Si ocurre un error durante la validación o el procesamiento, el Money Movement transiciona al estado final failed.

Si el Money Movement se crea con checker_approval = true, primero pasa a estado pending_approval y solo transicionará a processing o canceled una vez tomada la decisión de aprobación.

4. Los fondos se debitan
Una vez que el Money Movement transiciona a estado processing, los fondos se debitan del Cobre Balance asociado.

5. Espera el resultado final del Money Movement.

Si el Money Movement está completed, el beneficiario recibió los fondos exitosamente.

Si el Money Movement está rejected, los fondos se acreditan de vuelta a tu Cobre Balance.

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

Acciones realizadas sobre un Money Movement (Payout)

🔑 Create

🔍 Retrieval

Description: Creación de Money Movement.
What to expect after the action: El Money Movement se crea en Cobre.
📘 Learn more:

🔗 Create a Money Movement

Idempotencia de Money Movement

La creación de Money Movement admite idempotencia.

Las claves de idempotencia son válidas por 24 horas.

Cómo empezar

Antes de comenzar, recomendamos revisar las siguientes consideraciones.

Antes de usar esta API

Necesitas un Cobre Balance Global en USD

Para enviar fondos usando Global payouts in stable, debes tener una cuenta Cobre Balance Global activa en USD con fondos suficientes.

Crea la contraparte beneficiaria

Antes de crear un Money Movement de Payout, debes crear una contraparte Global Deposit Legal Entity o Global Deposit Natural Person (beneficiario).

Define la configuración del Payout

Decide el tipo de destino, monto y cualquier metadato requerido para procesar el Payout.

Implementa Webhooks para rastrear el estado del pago

Para mantenerte informado sobre el estado de las transacciones de Payout, recomendamos encarecidamente implementar Webhooks. Los Webhooks notifican a tu sistema cuando un pago se inicia, procesa, completa o falla. Suscríbete también a los eventos requeridos para recibir notificaciones sobre débitos y créditos de transacciones.

See Notifications & Subscriptions for more details.

Qué esperar tras usar esta API

Inicia el Payout

Una vez enviada la solicitud de creación del Money Movement, se creará con estado initiated.
Asegúrate de que tu sistema esté preparado para recibir actualizaciones de estado a medida que el Money Movement avanza en su ciclo de vida.

Rastrea el estado de la transacción

Monitorea el ciclo de vida del Payout usando Webhooks o endpoints de consulta.

Los fondos se entregan al beneficiario

Cuando el Payout es exitoso, los fondos se acreditan a la cuenta del beneficiario y el estado del Money Movement se actualiza en consecuencia.

Payouts globales en stable

Limitaciones de Global payouts in stable#

Contrapartes compatibles#

Flujo de autorización (opcional)#

Ciclo de vida del payout#

Acciones realizadas sobre un Money Movement (Payout)#

Idempotencia de Money Movement#

Cómo empezar#

Antes de usar esta API#

Qué esperar tras usar esta API#