Payouts globales en stable
Limitaciones de Global payouts en stable
| Red (Chain) | Stablecoins permitidas |
|---|---|
| Ethereum | USDT, USDC |
| Tron | USDT |
| Solana | USDC |
| Polygon | USDC |
| Base | USDC |
| XRPL | RLUSD |
verificada para permitir el payout.Contrapartes soportadas
| Tipo de destino | Tipo de contraparte |
|---|---|
| Global Deposit Legal Entity | global_deposit_le |
| Global Deposit Natural Person | global_deposit_np |
Flujo de autorización (opcional)
pending_approval hasta que sea aprobado o rechazado. El proceso de aprobación puede completarse a través del Portal de Cobre o de forma programática vía API.Ciclo de vida del Payout
Crea una contraparte de tipo
global_deposit_le o global_deposit_np.Esta contraparte representa el destino de la transacción de Payout.
Crea un Money Movement usando:
account_id desde el cual se debitarán los fondos, utilizado como source_id (un Global Cobre Balance en USD).counterparty_id del paso anterior como destination_id.description y el token.external_id, que puedes usar para enviar una referencia desde tu sistema.checker_approval en true si deseas usar nuestro flujo de autorización.Una vez creado, el Money Movement inicia en estado
initiated.processing. En este punto, la transacción es transmitida.failed.checker_approval = true, primero pasa al estado pending_approval y solo cambiará a processing o canceled una vez se tome una decisión de aprobación.Una vez que el Money Movement pasa al estado
processing, los fondos son debitados del Cobre Balance asociado.completed, el beneficiario ha recibido exitosamente los fondos.rejected, los fondos son acreditados de vuelta a tu Cobre Balance.Los cambios de estado del Money Movement se comunican vía Webhooks.
Acciones realizadas sobre un Money Movement (Payout)
🔑 Crear
🔍 Consulta
Descripción: Creación de Money Movement.
Qué esperar después de la acción: El Money Movement es creado en Cobre.
📘 Aprende más:
Qué esperar después de la acción: El Money Movement es creado en Cobre.
📘 Aprende más:
Idempotencia de Money Movement
Las claves de idempotencia son válidas por 24 horas.
Cómo empezar
Antes de usar esta API
Necesitas un Global Cobre Balance en USD
Para enviar fondos usando Global payouts en stable, debes tener una cuenta activa de Global Cobre Balance en USD con fondos suficientes.
Crear la contraparte beneficiaria
Antes de crear un Payout Money Movement, debes crear una contraparte de tipo Global Deposit Legal Entity o Global Deposit Natural Person (beneficiario).
Definir la configuración del Payout
Define el tipo de destino, el monto y cualquier metadata necesaria para procesar el Payout.
Implementar Webhooks para seguimiento del estado
Para mantenerte informado sobre el estado de las transacciones de Payout, recomendamos implementar Webhooks. Los Webhooks notifican a tu sistema cuando un pago es iniciado, procesado, completado o fallido. También suscríbete a los eventos necesarios para recibir notificaciones sobre débitos y créditos de transacciones.Consulta Notificaciones y Suscripciones para más detalles.
Qué esperar después de usar esta API
Iniciar el Payout
Una vez que se envía la solicitud de creación del Money Movement, este se crea con estado
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.
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.
Monitorear el estado de la transacción
Monitorea el ciclo de vida del Payout utilizando Webhooks o endpoints de consulta.
Los fondos se entregan al beneficiario
Cuando el Payout es exitoso, los fondos se acreditan en la cuenta del beneficiario y el estado del Money Movement se actualiza en consecuencia.
Modified at 2026-03-27 02:27:32