Crear un Movimiento de Dinero Genérico

Los Movimientos de Dinero Genéricos permiten enviar un payout a un beneficiario alcanzado a través de los rieles SWIFT, SEPA, CIPS o Fedwire — rieles bancarios no ligados a un flujo específico de país como Colombia, México o EE.UU. SWIFT, SEPA y CIPS enrutan payouts internacionales; Fedwire enruta payouts en USD a cuentas bancarias domiciliadas en EE.UU.

A diferencia del flujo de Movimiento de Dinero Transfronterizo descrito anteriormente, un Movimiento de Dinero Genérico no utiliza una Cotización FX: los fondos que envías ya están en la moneda del payout, y fondeas directamente un Cobre Balance Global.

Para crear un Movimiento de Dinero Genérico, sigue los pasos a continuación:

🌍 Crear una Contraparte Genérica

Registra al beneficiario como Contraparte con type: generic, proporcionando su identificación, dirección y datos de enrutamiento de pago para el riel swift, sepa, cips o fedwire.
Consulta Gestión de Contrapartes para la referencia completa de campos.

💰 Fondear el Cobre Balance Global de origen

Asegúrate de que el Cobre Balance Global desde el que pagarás tenga fondos suficientes en la moneda del payout.
Consulta Fondea tu Cobre Balance global.

🔑 Crear el Movimiento de Dinero

Vincula el Cobre Balance Global fondeado como source_id y la Contraparte Genérica como destination_id, usando la variante de metadata Genérica descrita abajo.

Combinación válida de origen y destino

Origen	Tipo de origen	Destino	Tipo de destino
account_id	Cobre Balance Global (type: `cobre_balance`)	counterparty_id	Contraparte Genérica (type: `generic`)

Metadata genérica

Esta variante de metadata aplica cuando:

El source_id hace referencia a un Cobre Global Balance

El destination_id hace referencia a una Contraparte cuyo type es generic

Campo	Descripción
`description`	Descripción del payout.
`category`	Campo para indicar el tipo de categoría asociado al Movimiento de Dinero.

Ambos campos son obligatorios.

Ciclo de vida y seguimiento de estado

Un Movimiento de Dinero Genérico sigue la misma máquina de estados de Payout que cualquier otro Movimiento de Dinero (initiated → processing → completed / failed / rejected, con un paso opcional pending_approval cuando se usa checker_approval).

Consulta la guía de Movimiento de Dinero para la máquina de estados completa, y Notificaciones y Suscripciones para suscribirte a eventos de cambio de estado en lugar de hacer polling.

Acciones sobre un Movimiento de Dinero Genérico

🔑 Crear

🔍 Consulta

Descripción: Crear un Movimiento de Dinero usando una Contraparte Genérica como destination_id.
Qué esperar: Se crea un objeto Movimiento de Dinero en estado initiated.

Cómo empezar

Antes de usar esta API

Crear una Contraparte Genérica

Registra al beneficiario con la identificación, dirección y datos de enrutamiento requeridos para el riel swift, sepa, cips o fedwire.
Consulta Crear una Contraparte.

Confirmar fondos en el Cobre Balance Global de origen

Consulta Cobre Balance API y Fondea tu Cobre Balance global.

Qué esperar después de usar esta API

Creación del Movimiento de Dinero

Se crea un Movimiento de Dinero en estado initiated, referenciando el Cobre Balance Global como origen y la Contraparte Genérica como destino.
Consulta Obtener un Movimiento de Dinero.

Creación de transacciones

Una vez que el movimiento alcanza el estado completed, se crean transacciones de débito y crédito en las cuentas de origen y destino.
Consulta Account Transactions API.

Crear un Movimiento de Dinero Genérico

Combinación válida de origen y destino#

Metadata genérica#

Ciclo de vida y seguimiento de estado#

Acciones sobre un Movimiento de Dinero Genérico#

Cómo empezar#

Antes de usar esta API#