Fast Pay & ACH

La solución de PayOuts usando Fast Pay / ACH proporciona servicios para enviar fondos desde un Cobre Balance a beneficiarios externos en Colombia utilizando rieles de pago rápidos y casi en tiempo real.

Los PayOuts de Fast Pay / ACH se utilizan comúnmente para desembolsar fondos de manera eficiente a cuentas bancarias u otros Cobre Balances, ofreciendo una experiencia de pago confiable y escalable para empresas y plataformas.

Diferencia entre Fast Pay y ACH

Fast Pay es la solución de pagos propietaria de Cobre, construida sobre una conexión directa entre cuentas bancarias, permitiendo tiempos de procesamiento más rápidos.

ACH, por otro lado, es el sistema estándar de transferencias interbancarias de Colombia.

Una de las principales diferencias entre ambos rieles radica en sus acuerdos de nivel de servicio (SLA), particularmente en el tiempo requerido para alcanzar el estado final de un movimiento de dinero. El enrutamiento entre Fast Pay y ACH se determina automáticamente según el banco del beneficiario, ya que no todas las instituciones financieras soportan la solución Fast Pay. Este comportamiento de enrutamiento no es configurable por el cliente.

Contrapartes soportadas

El Payout vía Fast Pay / ACH soporta los siguientes tipos de destino en Colombia:

Tipo de Destino	Tipo de Contraparte	Rieles
Cuenta Corriente	`cc`	Fast Pay / ACH
Cuenta de Ahorros	`ch`	Fast Pay / ACH
Depósito Electrónico	`dp`	Fast Pay / ACH
Cobre Balance	`cobre_balance`	Fast Pay

Para revisar qué bancos soportan Fast Pay y/o ACH, por favor consulte los siguientes Códigos Bancarios Colombianos.

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 pagos. Mientras la aprobación está pendiente, el Money Movement permanece en estado pending_approval hasta que sea 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

Un Payout a través de Fast Pay o ACH sigue un ciclo de vida simple:

1. Crear una contraparte (beneficiario)
Crea una contraparte con la información del beneficiario.
Esta contraparte representa el destino de la transacción de Payout.

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

El account_id del cual se debitarán los fondos, usado como source_id.

El counterparty_id del paso anterior como destination_id

Los metadatos con una description

El external_id donde puedes enviar una referencia desde tu sistema.

El monto proporcionado en la unidad más pequeña de la moneda (ej., 100.00 COP debe representarse como 10000).

El 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 envía a través de Fast Pay o ACH.

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

Si el Money Movement se crea con 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.

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

5. Esperar el resultado final del Money Movement.

Si el Money Movement está completed, el beneficiario ha recibido exitosamente los fondos.

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

6. Recibir actualizaciones de estado
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: Money Movement se crea en Cobre.
📘 Aprende más:

🔗 Crear un Money Movement

Idempotencia del Money Movement

La creación de Money Movement soporta idempotencia.

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

Cómo Comenzar

Antes de empezar, recomendamos revisar las siguientes consideraciones.

Antes de usar esta API

Necesitas un Cobre Balance en Colombia

Para enviar fondos usando Fast Pay / ACH, debes tener una cuenta Cobre Balance activa en Colombia con fondos suficientes.

Crear la Contraparte beneficiaria

Antes de crear un Money Movement de Payout, debes crear una Contraparte con la información del beneficiario, que coincida con el tipo de destino seleccionado.

Definir la configuración del Payout

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

Implementar Webhooks para rastrear el estado del pago

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

Ve 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, se creará con estado 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.

Rastrear 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 acordemente.

Fast Pay & ACH

Diferencia entre Fast Pay y ACH#

Contrapartes soportadas#

Flujo de Autorización (opcional)#

Ciclo de vida del Payout#

Acciones realizadas en un Money Movement (Payout)#

Idempotencia del Money Movement#

Cómo Comenzar#

Antes de usar esta API#

Qué esperar después de usar esta API#