Payouts con Fedwire
Limitaciones de Fedwire y comportamiento de enrutamiento
failed y los fondos serán devueltos a tu Cobre Balance.Contrapartes soportadas
| Tipo de Destino | Tipo de Contraparte | Rails |
|---|---|---|
| Cuenta Bancaria Empresarial EE. UU. | business | Fedwire |
Supported providers
pr_usa_cobre | Fedwire |Flujo de Autorización (opcional)
pending_approval hasta que es aprobado o rechazado. El proceso de aprobación puede completarse a trav és del Portal Cobre o programáticamente vía API.Ciclo de vida del Payout
Crea una contraparte de tipo
business usando la información de la cuenta bancaria en EE. UU. del beneficiario, incluyendo su número de routing ABA y número de cuenta.Esta contraparte representa el destino de la transacción PayOut.
Crea un Money Movement usando:
account_id desde el cual los fondos serán debitados, usado como source_id. La cuenta debe usar un proveedor pr_usa_cobre.counterparty_id del paso anterior como destination_id.description. La contraparte debe tener la geografía establecida como USA y el tipo como Business.external_id donde puedes enviar una referencia desde tu sistema.10000).checker_approval como true si quieres usar nuestro flujo de autorización.Horarios de corte de Fedwire
Requisitos de información del beneficiario
Una vez creado, el Money Movement inicia en el estado
initiated.processing. En este punto, la transacción es enviada al Fedwire Funds Service.failed.checker_approval = true, primero se mueve al estado pending_approval y solo transicionará a processing o canceled una vez que se tome la decisión de aprobación.Una vez que el Money Movement transiciona al estado
processing, los fondos son debitados del Cobre Balance asociado.completed, el beneficiario ha recibido los fondos exitosamente.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 en 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 Comenzar
Antes de usar esta API
Necesitas un Cobre Balance en Estados Unidos
Para enviar fondos usando Fedwire, debes tener una cuenta Cobre Balance activa en Estados Unidos con fondos suficientes.
Crea la Contraparte del beneficiario
Antes de crear un Money Movement de PayOut, debes crear una Contraparte con la información de la cuenta bancaria en EE. UU. del beneficiario, incluyendo su número de routing ABA y número de cuenta.
Define la configuración del PayOut
Decide el tipo de destino, monto y cualquier metadata requerida para procesar el PayOut. Confirma que la transacción se enviará dentro del horario operativo de Fedwire.
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 es iniciado, procesado, completado o fallido. También suscríbete a los eventos requeridos para recibir notificaciones sobre débitos y créditos de transacciones.Ver Notificaciones y Suscripciones para más detalles.
Qué esperar después de usar esta API
Inicia el PayOut
Una vez enviada la solicitud de creación del Money Movement, se creará con un estado
Asegúrate de que tu sistema esté preparado para recibir actualizaciones de estado mientras el Money Movement progresa a través de su ciclo de vida.
initiated.Asegúrate de que tu sistema esté preparado para recibir actualizaciones de estado mientras el Money Movement progresa a través de 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 son entregados al beneficiario
Cuando el PayOut es exitoso, los fondos son acreditados a la cuenta bancaria en EE. UU. del beneficiario y el estado del Money Movement se actualiza en consecuencia.
Modified at 2026-07-16 19:56:47