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?

sequenceDiagram
    participant Dev as Tu servidor
    participant Conekta
    participant Bank as Banco del beneficiario

    Dev->>Conekta: POST /payouts/payees (alta de beneficiario)
    Conekta->>Bank: Depósito simbólico de validación
    Bank-->>Conekta: Confirmación de titular
    Conekta-->>Dev: validation_status: validated_active
    Dev->>Conekta: POST /payout_rules (instrucción de dispersión)
    Note over Conekta: Cada noche: evalúa instrucciones activas,<br/>calcula saldo disponible
    Conekta->>Bank: Envío SPEI al beneficiario
    Conekta-->>Dev: Webhook de estado de la dispersión

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. Configuras una instrucción de dispersión 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).
3. Cada noche, Conekta evalúa las instrucciones activas del día, calcula los montos a partir de tu saldo disponible (o de un depósito directo que hayas hecho) y ejecuta el envío por SPEI.
4. Puedes consultar el estado de cada dispersión y del grupo de dispersiones 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

Los pagos a beneficiarios se fondean de dos formas:

• Con tu saldo disponible en Conekta. Cuando tus transacciones están disponibles (available_on cumplido), Conekta calcula automáticamente lo necesario para cubrir los pagos programados del día.
• Con un depósito directo. También puedes fondear tu cuenta de dispersiones directamente por SPEI.

Ningún pago se ejecuta sin saldo suficiente. Si el saldo no alcanza para todas las instrucciones de un día, Conekta dispersa las que sí puede cubrir y reintenta automáticamente el resto en cuanto se reciba un fondeo adicional. 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.