Resumen

Definición

Esta funcionalidad te permite automatizar el envío de dinero a terceros (proveedores, empleados, socios u otros beneficiarios) a través de SPEI, usando el saldo disponible en tu cuenta de Conekta o un depósito que tú mismo hagas.

A diferencia de una dispersión puntual, esta funcionalidad está pensada para flujos recurrentes y programados: nómina, pagos a proveedores, comisiones, liquidaciones periódicas, etc.

📘

Importante

Antes de utilizar esta funcionalidad debes consultar con tu Ejecutivo de Cuentas de Conekta si se encuentra disponible para tu negocio, o escríbenos a [email protected]. La activación requiere la firma de un acuerdo con las condiciones y tarifas del servicio.

¿Cómo funciona?

Una dispersión mueve dinero desde tu cuenta en Conekta hacia la cuenta bancaria de un beneficiario. Intervienen dos cuentas tuyas:

• Balance Conekta: donde se acumula el dinero de tus cobros.
• Cuenta de dispersiones: desde donde salen los pagos a tus beneficiarios.

El dinero llega al beneficiario cuando pasa por tu cuenta de dispersiones. El flujo consiste en registrar al beneficiario, crear la instrucción, fondear la cuenta de dispersiones y ejecutar el envío.

1. Registras un beneficiario (payee) con los datos de su cuenta bancaria (CLABE). Conekta valida automáticamente la cuenta antes de habilitarla para recibir pagos.
2. Creas una instrucción de dispersión (payout_rule) que indica a qué beneficiario, cuánto y cuándo pagar: una sola vez, en una fecha específica, o de forma recurrente (diaria, semanal o mensual).

La fecha de la instrucción decide cuándo se ejecuta.

Dispersión para hoy

Una instrucción one_time (no tiene fecha propia: aplica desde que la creas) o una scheduled/recurrent cuya fecha es hoy se intenta ejecutar de inmediato contra el saldo de tu cuenta de dispersiones:

• Con saldo suficiente, el dinero sale al beneficiario en ese momento.
• Sin saldo, la instrucción queda en espera. La cubre el siguiente fondeo: el traspaso automático del proceso de apertura del día o un depósito directo tuyo. Si el día termina sin fondos y la instrucción tiene auto_retry_on_insufficient_funds activo, vuelve al proceso de apertura del día siguiente; sin ese flag, la reintentas manualmente.

Ver Ejecución on-demand para el detalle del intento inmediato y qué pasa si falla.

Dispersión programada para otro día

Una instrucción scheduled o recurrent con fecha futura queda guardada hasta ese día. El proceso de apertura de la fecha correspondiente la fondea desde tu Balance Conekta y la ejecuta, con las mismas reglas de saldo.

El proceso de apertura del día

Cada día, un solo proceso abre las dispersiones del día y las fondea desde tu Balance Conekta. Corre en dos momentos:

• 00:00 — cálculo. Junta los compromisos del día (las instrucciones con fecha de hoy más las que quedaron pendientes por falta de fondos el día anterior con auto_retry_on_insufficient_funds activo) y calcula cuánto falta: lo que necesitas hoy − lo que ya tienes en tu cuenta de dispersiones = lo que se traspasa desde tu Balance Conekta.
• Entre 10am y 2pm (aprox.) — traspaso y ejecución. Conekta mueve ese monto desde tu Balance Conekta a tu cuenta de dispersiones. En cuanto el dinero llega, empiezan a ejecutarse las dispersiones del día, una a una hacia su beneficiario.

flowchart TD
    A["Proceso de apertura del día · 00:00"] --> B["Compromisos de hoy<br/>+ pendientes de ayer con reintento activo"]
    B --> C["Necesitas hoy − saldo en dispersiones<br/>= monto a traspasar"]
    C --> D["10am–2pm aprox.<br/>Traspaso: Balance Conekta → cuenta de dispersiones"]
    DEP["Depósito SPEI directo<br/>(en cualquier momento)"] --> E
    D --> E["Llega saldo a la cuenta de dispersiones"]
    E --> F["Se ejecutan las dispersiones del día"]
    F --> G{"¿El saldo alcanzó?"}
    G -->|Sí| H["El dinero llega al beneficiario"]
    G -->|No| I["Pendiente de fondeo directo;<br/>reintenta mañana si tiene reintento activo"]

Lo que el traspaso no alcance a cubrir queda pendiente de un depósito directo tuyo, y vuelve al proceso de apertura del día siguiente si la instrucción tiene reintento activo.

Sin importar qué la disparó, puedes consultar el estado de cada dispersión y del grupo del día en cualquier momento.

Antes de empezar

• Una cuenta Conekta con la funcionalidad activada (ver nota arriba) y tus API Keys.
• Un Webhook configurado si quieres recibir actualizaciones de estado sin hacer polling — recuerda verificar la firma de cada notificación antes de procesarla.

Beneficiarios (payees)

Un beneficiario es el destinatario de los fondos. Para poder recibir pagos, un beneficiario debe pasar por una validación automática de cuenta:

🚧

Validación automática

Al crear un beneficiario, Conekta deposita un monto simbólico a la cuenta indicada para confirmar que existe y que el nombre del titular coincide con el que registraste. Este proceso es asíncrono: el beneficiario queda en pending_validation y cambia de estado en cuanto se recibe la confirmación (normalmente en menos de dos minutos).

Puedes dar de alta beneficiarios uno por uno o en lote mediante un archivo CSV. Consulta la guía de Gestión de beneficiarios.

Tipos de dispersión

Una instrucción de dispersión define cuánto pagarle a un beneficiario y con qué periodicidad. Elige uno de estos tipos:

Consulta el detalle completo en Tipos de dispersión.

Fondeo

Tu cuenta de dispersiones se fondea de dos formas:

• Automático, en el proceso de apertura del día. Conekta traspasa desde tu Balance Conekta (el saldo de tus cobros ya disponibles, con available_on cumplido) el monto que falta para cubrir los compromisos del día. Ver ¿Cómo funciona?.
• Directo. Depositas por SPEI a tu cuenta de dispersiones en cualquier momento; ese saldo cubre lo que el traspaso automático no alcanzó.

Ninguna dispersión se ejecuta sin saldo suficiente. Cuando el saldo no alcanza para todas las instrucciones de un día, Conekta dispersa las que sí puede cubrir y deja el resto pendiente hasta el próximo fondeo. Consulta Tipos de dispersión para el criterio exacto que decide qué se dispersa primero.

Costos

📘

Tarifas

Las tarifas exactas dependen de tu acuerdo comercial con Conekta. Consulta a tu Ejecutivo de Cuentas para conocer el detalle aplicable a tu negocio.

Seguimiento y estados de cuenta

Puedes consultar en cualquier momento el detalle de tus dispersiones, próximas y pasadas. Consulta Seguimiento de dispersiones.

En el menú de Finanzas, módulo Estado de cuenta, también encontrarás reflejados los movimientos correspondientes a tus dispersiones a terceros.

Próximamente

Estamos trabajando en soportar además:

• Vincular un beneficiario directamente a una orden o cobro, para que el pago a terceros se dispare automáticamente cuando esa transacción esté disponible (sin depender de una instrucción programada).
• Consulta directa de saldo disponible para dispersiones y gestión de instrucciones puntuales de forma independiente.

Si te interesa alguna de estas capacidades, contáctanos en [email protected].

Related

• Gestión de beneficiarios — cómo crear, consultar y editar beneficiarios vía API.
• Tipos de dispersión — cómo configurar pagos puntuales, programados y recurrentes.
• Seguimiento de dispersiones — cómo consultar el estado de tus dispersiones.
• Verificar firmas de Webhooks — valida la autenticidad de las notificaciones antes de procesarlas.